understanding.md
Understand the APIs
These guides explain the conventions shared across the MK.IO APIs, including authentication, pagination, rate limits, errors, and resource states.
- API overview: Learn the shared base URL, authentication, list responses, and resource states.
- Pagination: Understand how list responses expose pages of resources.
- Rate limits: Learn how the APIs communicate request limits.
- Error handling: Interpret API errors and handle failed requests.
- Resource states: Track the state of resources and long-running operations.
- Webhooks: Understand event notifications from the platform.