ByDomuReferencia de la API
La API v1 de ByDomu es REST con JSON. Esta referencia se genera desde la spec OpenAPI, que a su vez sale del código de las rutas: cada endpoint trae sus parámetros, el permiso que pide y ejemplos. No hay SDK oficial; con la spec puedes generar tu cliente.
https://api.bydomu.com/v1Autenticación
La clave va en el encabezado X-API-Key (no se acepta Authorization: Bearer). Se crea en ByDomu, en Configuración › API Keys, y la completa se ve una sola vez.
curl https://api.bydomu.com/v1/me \
-H "X-API-Key: $BYDOMU_API_KEY"domu_pk_live_publicabledomu_sk_live_secretadomu_live_legadoNiveles de acceso
Paginación
Los listados reciben page (desde 1) y pageSize, y responden con los datos y el total. Cada endpoint dice su pageSize máximo. Contactos, negocios y tareas aceptan además cursor.
{
"data": [ … ],
"meta": { "total": 64, "page": 1, "pageSize": 12, "totalPages": 6 }
}Errores
Siempre con la misma forma. Los datos que no pasan la validación del esquema responden 400 con la lista de problemas.
{
"error": {
"code": "FORBIDDEN",
"message": "La API key no tiene el scope requerido: contacts:read"
}
}VALIDATION_ERRORDatos de entrada inválidosUNAUTHORIZEDClave faltante o inválidaPAYMENT_REQUIREDCuenta en solo lectura: escritura rechazadaFORBIDDENLa clave no tiene ese permisoSECRET_KEY_IN_BROWSERClave secreta usada desde un navegadorAPI_ACCESS_REQUIREDEl nivel de la cuenta no permite esta clavePLAN_LIMIT_REACHEDSe alcanzó un tope del planNOT_FOUNDRecurso no encontradoIDEMPOTENCY_CONFLICTIdempotency-Key reutilizada con otro cuerpoRATE_LIMITEDLímite por minuto superadoLímites
Una clave publicable tiene 300 peticiones y 60 escrituras por minuto; una secreta, 60 y 30. Soporte puede aprobar más. Cada respuesta trae X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; al pasarte, 429 RATE_LIMITED con Retry-After.
En cualquier escritura puedes mandar Idempotency-Key: un reintento con la misma clave y el mismo cuerpo devuelve la respuesta original con Idempotency-Status: replayed. Vive 24 horas.