API para desarrolladores
Consulta tus cuentas de cobro, clientes y pagos desde otro sistema con una API de solo lectura.
En Cobrosly: Configuración → Desarrolladores
Cómo funciona
«Desarrolladores»: la API de Cobrosly, para que otro sistema consulte tus datos.
- Crea una API key y elige qué puede leer: cuentas de cobro, clientes, pagos, cotizaciones, recurrentes y los datos de la organización. La clave se muestra una sola vez.
- La API es de solo lectura: no crea ni modifica nada. Cada clave admite hasta 120 consultas por minuto.
- En «Uso» ves las consultas del mes; en «Documentación», cómo llamarla.
Para que funcione
- Suscripción: la API viene en los planes que la incluyen.
Consejo: Al crear una clave puedes ponerle vencimiento, y la puedes revocar cuando quieras.
Crear una clave y usarla
- En Configuración → Desarrolladores (propietario o administrador), pestaña «API Keys», pulsa «Crear API key».
- Ponle un «Nombre», marca los «Permisos» y, si quieres, «Vence en (días)». En blanco, no vence.
(abre la imagen en tamaño completo, en otra pestaña) - Copia la clave: empieza por ck_live_ y no se vuelve a mostrar.
- Llama a la API con el encabezado Authorization: Bearer seguido de tu clave. La pestaña «Documentación» tiene cada consulta y el botón «Copiar documentación».
Qué puedes consultar
Todo es de lectura, bajo https://cobrosly.com/api/v1/: los datos de tu cuenta y, en lista y por id, clientes, cuentas de cobro, cotizaciones, recurrentes y pagos.
Problemas comunes
La API me responde 429
Pasaste el límite de 120 consultas por minuto de esa clave. Espera lo que indica el encabezado Retry-After y vuelve a intentar.
«La API está disponible en el plan Empresa»
El plan se revisa en cada consulta: si la organización pasa al plan Independiente, las claves dejan de responder. Durante la prueba la API sí funciona. Con la suscripción en solo lectura, la API tampoco responde hasta que pagues un plan.
Perdí la clave
No se puede volver a ver. Revócala y crea otra.