Hotmart API Skill

This skill provides context and instructions for working with the Hotmart API (v1). The API is vast, so the documentation is organized by domain using a progressive disclosure strategy.

Do not hallucinate API endpoints or parameters. Always refer to the specific domain reference file before implementing a new API call.

1. Core API Concepts

These foundational concepts apply globally across all domains:

1.1. Authentication

• Protocol: OAuth 2.0 Client Credentials flow.
• Process: Generate credentials (client_id, client_secret) on the platform and get the token by making a POST to /security/oauth/token with an Authorization: Basic [credentials_base64] header.
• Expiration: Tokens are short-lived. Integration logic must automatically intercept 401 Unauthorized responses and request a new token.
• Reference: See auth.md for curl payloads and specific implementation rules.