https://github.com/datocms/js-rest-api-clients
REST API clients to interact with DatoCMS
https://github.com/datocms/js-rest-api-clients
Last synced: about 1 year ago
JSON representation
REST API clients to interact with DatoCMS
- Host: GitHub
- URL: https://github.com/datocms/js-rest-api-clients
- Owner: datocms
- License: mit
- Created: 2022-04-11T09:50:06.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T06:07:26.000Z (about 1 year ago)
- Last Synced: 2025-04-09T18:16:49.059Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 2.31 MB
- Stars: 11
- Watchers: 3
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
👉 [Visit the DatoCMS homepage](https://www.datocms.com) or see [What is DatoCMS?](#what-is-datocms)
---
[](https://github.com/datocms/js-rest-api-clients/actions/workflows/node.js.yml)
# DatoCMS JS REST API Clients
This monorepo contains API clients to interact with DatoCMS:
- `@datocms/cma-client-browser`: Client for the [Content Management API](https://www.datocms.com/docs/content-management-api) (to be used in browser environments).
- `@datocms/cma-client-node`: Client for the [Content Management API](https://www.datocms.com/docs/content-management-api) (to be used in NodeJS environments).
- `@datocms/dashboard-client`: Client for the Dashboard Management API (can be used in any JS environment).
- `@datocms/rest-api-events`: Can be used with any of the above clients to use real-time updates instead of polling to retrieve the result of asyncronous jobs.
You can read more on how to use these clients on the [official documentation page](https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients).
Looking for a client for the GraphQL [Content Delivery API](https://www.datocms.com/docs/content-delivery-api)? It's here: [@datocms/cda-client](https://github.com/datocms/cda-client)
## Development
After checking out the repo, run the following:
```
npm install
lerna bootstrap
npm run build
```
Then, to run the test suite: `npm run test`.
To regenerate the code based on the latest DatoCMS JSON API schema:
```
npm run generate
npm run build
```
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/datocms/js-rest-api-clients. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
## License
The package is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
---
# What is DatoCMS?
[DatoCMS](https://www.datocms.com/) is the REST & GraphQL Headless CMS for the modern web.
Trusted by over 25,000 enterprise businesses, agencies, and individuals across the world, DatoCMS users create online content at scale from a central hub and distribute it via API. We ❤️ our [developers](https://www.datocms.com/team/best-cms-for-developers), [content editors](https://www.datocms.com/team/content-creators) and [marketers](https://www.datocms.com/team/cms-digital-marketing)!
**Why DatoCMS?**
- **API-First Architecture**: Built for both REST and GraphQL, enabling flexible content delivery
- **Just Enough Features**: We believe in keeping things simple, and giving you [the right feature-set tools](https://www.datocms.com/features) to get the job done
- **Developer Experience**: First-class TypeScript support with powerful developer tools
**Getting Started:**
- ⚡️ [Create Free Account](https://dashboard.datocms.com/signup) - Get started with DatoCMS in minutes
- 🔖 [Documentation](https://www.datocms.com/docs) - Comprehensive guides and API references
- ⚙️ [Community Support](https://community.datocms.com/) - Get help from our team and community
- 🆕 [Changelog](https://www.datocms.com/product-updates) - Latest features and improvements
**Official Libraries:**
- [**Content Delivery Client**](https://github.com/datocms/cda-client) - TypeScript GraphQL client for content fetching
- [**REST API Clients**](https://github.com/datocms/js-rest-api-clients) - Node.js/Browser clients for content management
- [**CLI Tools**](https://github.com/datocms/cli) - Command-line utilities for schema migrations (includes [Contentful](https://github.com/datocms/cli/tree/main/packages/cli-plugin-contentful) and [WordPress](https://github.com/datocms/cli/tree/main/packages/cli-plugin-wordpress) importers)
**Official Framework Integrations**
Helpers to manage SEO, images, video and Structured Text coming from your DatoCMS projects:
- [**React Components**](https://github.com/datocms/react-datocms)
- [**Vue Components**](https://github.com/datocms/vue-datocms)
- [**Svelte Components**](https://github.com/datocms/datocms-svelte)
- [**Astro Components**](https://github.com/datocms/astro-datocms)
**Additional Resources:**
- [**Plugin Examples**](https://github.com/datocms/plugins) - Example plugins we've made that extend the editor/admin dashboard
- [**Starter Projects**](https://www.datocms.com/marketplace/starters) - Example website implementations for popular frameworks
- [**All Public Repositories**](https://github.com/orgs/datocms/repositories?q=&type=public&language=&sort=stargazers)