Saltar al contenido principal
Cada consulta a la API consume créditos según su costo real: un rastreo dispara decenas de lecturas a las fuentes de datos; una consulta puntual, una. Tu plan fija cuántas consultas por minuto podés hacer y cuántos créditos tenés por mes.

Planes

  • El plan es el de tu organización, y tus claves lo heredan.
  • En enterprise, el cupo es de toda la organización: la web, las claves de sus miembros y las claves de la organización suman al mismo cupo y se cortan al llegar.
  • El cupo se renueva el 1 de cada mes a las 00:00 UTC.

Lo que se cobra y lo que no

Solo se cobran las respuestas exitosas (status menor a 400).
  • Una respuesta de error (4xx o 5xx) queda registrada con 0 créditos.
  • Si la fuente de datos no pudo leer lo que pediste, la respuesta es 503 source_unavailable y no se cobra.
  • Un 200 que trae degraded_sources sí se cobra: la consulta se respondió y lo que faltó está declarado en la respuesta. Ver Errores.
  • Las respuestas 401, 402 y 429 se cortan antes de ejecutar la consulta.

Cuánto cuesta cada consulta

El costo se decide por método y ruta: vale el prefijo de ruta más largo que tenga precio. Una ruta sin precio propio cuesta 1 crédito. GET /v1/evidence/signing-key y GET /v1/evidence/timestamp/{name} son abiertos: no piden clave ni cobran. Sirven para verificar la firma de un documento sin depender de una cuenta.

Ver tu saldo

Cada respuesta autenticada trae estos headers: Para el detalle por endpoint, GET /v1/account (sin costo):
  • credits es el saldo con la misma cuenta que los headers: reserved son los créditos que tienen tomados tus consultas en curso. En enterprise, shared es true cuando el saldo es el de la organización.
  • limits.request_source_calls es el tope de lecturas a las fuentes por consulta (ver abajo).
  • failed cuenta las consultas que terminaron en error, registradas con 0 créditos.

Cuando llegás a un límite

Además, cada consulta tiene un tope de lecturas a las fuentes de datos (por defecto, 4,000; la organización puede tener otro). Si un rastreo llega al tope, las lecturas que faltan no se hacen: la consulta raíz responde 503 o el paso queda en degraded_sources, con reason: "budget_exhausted". Nunca es un resultado vacío.