Introducción
Conoce la plataforma y encuentra el punto de partida adecuado para tu integración.
Esta documentación es una guía práctica para integrar los productos y APIs de Madre From Bits. La estructura está pensada para avanzar desde una primera solicitud hasta una integración mantenible, observable y fácil de extender.
Autenticación
Protege tus solicitudes con una API key y mantén tus credenciales fuera del cliente.
Incluye tu API key como bearer token en el encabezado de cada solicitud. Guarda las credenciales en variables de entorno y nunca las expongas en código que se ejecute en el navegador.
Primeros pasos
Realiza tu primera solicitud y valida una respuesta útil en pocos minutos.
Comienza con una solicitud pequeña. Valida el código de respuesta, registra el identificador de operación y conecta el resultado a tu flujo sólo después de confirmar el caso básico.
Referencia de API
Consulta endpoints, formatos y convenciones para construir integraciones predecibles.
Las APIs utilizan JSON y siguen convenciones consistentes para entradas, salidas y errores. Los fragmentos de esta sección son ejemplos editables, no credenciales reales.
Errores
Entiende los errores y diseña respuestas útiles para tus usuarios.
Los errores deben tratarse como parte del contrato. Registra el código, conserva el identificador de solicitud y comunica una acción concreta cuando sea posible.
Límites de uso
Planifica tus solicitudes y evita interrupciones inesperadas en producción.
Distribuye las solicitudes cuando el flujo lo permita y prepara reintentos con backoff. Los límites concretos dependerán del producto y del plan configurado.
Una solicitud, tres formas.
curl -X POST /v1/report \
-H "Authorization: Bearer TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"formato":"pdf","origen":"resumen_ventas"}'