Estado de la API

Esta página es lo que se puede hacer mientras tanto, y responde la pregunta que importa en el momento: ¿el problema es mío o es de ustedes?

La llamada que sirve de prueba

GET /public/v1/me responde a cualquier clave válida y no exige ningún permiso específico. Es la llamada más barata para saber si la API está respondiendo y si su clave está bien.

200: la API está en el aire y su clave vale. El problema está en la otra llamada, no en la API.
Cualquier otra cosa: use la lista de abajo.

El comando está en Primeros pasos, en los cuatro lenguajes de código.

No busque una dirección de verificación de salud: en el host de la API solo responden /public/v1 y el security.txt. Todo lo demás responde 404.

De quién es el problema

La respuesta ya dice de qué lado está el arreglo. Lo que manda es el code, no el texto.

Es de su lado

401 api_key_invalid. Encabezado, clave, estado de la clave y lista de IPs. La guía completa está en Autenticación.
403 permission_missing, member_permission_denied, access_denied. Permiso de la clave y rol del miembro. Vea Permisos.
403 subscription_inactive, plan_feature_unavailable, plan_limit_reached, organization_suspended. Suscripción, plan o estado de la empresa. El arreglo está en el panel.
404 route_not_found. Ruta o host equivocado.
422 validation_failed. El cuerpo trae errors, campo por campo.
429 rate_limit_exceeded. Espere el tiempo del Retry-After antes de repetir. Vea Límites de uso.

Es de nuestro lado

500 internal_error. Guarde el request_id y escriba.
503 service_unavailable. Intente de nuevo en unos instantes. Si persiste, escriba.

Es la red en el medio

Sin respuesta, tiempo agotado, error de TLS. La llamada no llegó hasta nosotros, o la respuesta no llegó hasta usted. Pruebe desde otra red antes de escribir.

El 429 también aparece cuando una misma dirección acumula fallas de autenticación, incluso con la clave correcta. Ahí el arreglo es dejar de repetir la llamada equivocada, y no esperar a que la API vuelva.

Cómo saber si es general o solo con usted

Repita desde otra red. Otro servidor, su computadora, el celular fuera del Wi-Fi de la empresa. Si funciona desde un lugar y no desde otro, el problema está en el camino, no en la API. Si la clave tiene lista de IPs, la llamada desde otra red va a recibir 401 y eso es lo esperado: pruebe con una clave sin lista, o saque conclusiones solo de los errores 500 y 503.
Repita después de un minuto. 429 y 503 son temporales por naturaleza.
Mire Ver uso en el panel. Si la llamada ni aparece ahí, nunca llegó a ser reconocida como suya, y el problema está en el encabezado, en el token o en el host.
Cuente. Varias llamadas seguidas con 500 o 503, desde más de una red, es problema nuestro. Una llamada aislada con 500 en medio de cientos que funcionan también vale un correo, con el request_id.

Qué no prometemos acá

No publicamos métrica de disponibilidad, no anunciamos ventanas de mantenimiento y no prometemos aviso de indisponibilidad. Escribir cualquiera de esas cosas sin el proceso detrás sería adorno, y el adorno en una página de estado es peor que nada.

Lo que la documentación garantiza sobre cambios del contrato es otra cosa, y esa sí tiene una traba automática: vea Versiones y changelog.

Cuándo escribir

Reúna el request_id, el horario con la zona, el método, la ruta, el estado y el code, y mándelo a dev@fatureihoje.com. La lista completa está en Contacto.

Próximo paso

Contacto: qué tener a mano antes de escribir.
Límites de uso: los encabezados que dicen cuánto queda de su presupuesto.
Errores: qué quiere decir cada code.