Planes y límites de la API y Webhooks

El acceso a la API REST y a los Webhooks depende del plan activo de tu organización, no de si tu equipo ya tiene una API Key creada o un webhook configurado. Si tu plan no incluye alguna de estas dos capacidades, la plataforma te lo va a indicar en el momento de intentar usarla.

Qué pasa si tu plan no incluye API

Si intentas autenticarte contra /login como usuario de API, o llamar a cualquier endpoint protegido de la API pública, y tu organización no tiene el plan que habilita el acceso a la API, la respuesta es:

HTTP 402 Payment Required

🔎 Fíjate en: el código es 402, no 401. Un 402 significa “tu plan no incluye esto”, no “tu token es inválido” — si ves un 402, no es un problema de autenticación, es un tema de plan.

Este código aplica tanto al login de API User como a cualquier endpoint protegido en https://public-api.acreditta.com. La excepción es /credential/record/{credentialId}, que se mantiene accesible sin este control por compatibilidad con integraciones antiguas de constancias/PDF.

Qué pasa si tu plan no incluye Webhooks

Si tu organización no tiene el plan que habilita webhooks, cualquier llamada a /api/v1/integrations/webhooks/* responde:

HTTP 400 Bad Request

Y en el panel de administración, la pestaña Webhooks (dentro de Integraciones → API) se reemplaza por un aviso para mejorar tu plan, en vez de mostrarte el formulario de creación.

Cómo saber si tu plan incluye estas capacidades

La forma más directa es intentar crear una API Key o un webhook desde el panel: si tu plan no las incluye, la misma interfaz te lo indica con una opción para mejorar tu plan. Si tienes dudas sobre qué incluye tu plan actual, contacta a tu ejecutivo de cuenta o a tech@acreditta.com.

Siguiente paso


CONTENIDO

Powered By EazyDocs