La API REST ofrece acceso programático a los datos de su empresa. Está pensada para desarrolladores que crean una integración; no la necesita para el uso diario.
- Referencia de la API: la referencia completa es pública en /docs/api en la dirección de su espacio de trabajo, con el documento OpenAPI en /docs/api/openapi.yaml y /docs/api/openapi.json. API y webhooks en Configuración enlaza con ella.
- URL base: se muestra en la parte superior de API y webhooks. Termina en /api/v1.
- Autenticación: envíe la cabecera Authorization: Bearer seguida de su token, y Accept: application/json.
- Respuestas: solo JSON. Los registros individuales van envueltos en data; las listas añaden meta y links para la paginación por cursor (parámetros limit y cursor, hasta 100 por página).
- Reintentos seguros: envíe una cabecera Idempotency-Key en las solicitudes POST. Repetir la misma solicitud con la misma clave devuelve la respuesta guardada en lugar de crear un segundo registro. Las claves se conservan durante 24 horas.
- Límite de solicitudes: 120 solicitudes por minuto por token. Las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining muestran dónde se encuentra; por encima del límite recibe un 429 con una cabecera Retry-After.
Qué puede hacer una solicitud
Una llamada solo tiene éxito cuando el token tiene la capacidad (por ejemplo, invoices:write) y el usuario del token tiene el permiso correspondiente en la aplicación. Se aplican las mismas reglas de negocio que en pantalla, por lo que una factura emitida tampoco se puede editar a través de la API.
Guías relacionadas
Pregunte sobre el producto
Pregunte qué puede hacer el software, cómo funciona una tarea o qué países e idiomas admite. Las respuestas proceden de estas guías.
Pensando…
El asistente de IA no está disponible en este momento. Busque en las guías o hable con nuestro equipo. Contactar con soporte
La IA puede cometer errores. Consulte las guías enlazadas.
¿Todavía necesita ayuda?
Nuestro equipo de soporte lee cada mensaje y responde en un lenguaje claro.
Contactar con soporte