Introduction
Learn about the platform and find the right starting point for your integration.
This documentation is a practical guide to integrating Madre From Bits products and APIs. It is structured to take you from a first request to a maintainable, observable integration.
Authentication
Protect requests with an API key and keep credentials out of the client.
Include your API key as a bearer token in every request header. Store credentials in environment variables and never expose them in browser code.
Getting started
Make your first request and validate useful output in minutes.
Start with a small request. Validate the response code, keep the operation identifier and connect the result to your flow only after the basic case works.
API reference
Review endpoints, formats and conventions for predictable integrations.
Our APIs use JSON and consistent conventions for inputs, outputs and errors. The snippets in this section are editable examples, not real credentials.
Errors
Understand errors and design useful responses for your users.
Treat errors as part of the contract. Keep the code and request identifier, and communicate a concrete next action whenever possible.
Rate limits
Plan requests and avoid unexpected interruptions in production.
Distribute requests when possible and prepare retries with backoff. Exact limits depend on the product and configured plan.
One request, three ways.
curl -X POST /v1/report \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"formato":"pdf","origen":"resumen_ventas"}'