Documentación de la API

La API pública de Faturei Hoje es el camino para que otro sistema hable con tu empresa en Faturei Hoje sin pasar por el panel: llamadas HTTP, autenticadas con una clave que creas y revocas cuando quieras.

Esta documentación se está escribiendo. La Referencia ya muestra, campo por campo, lo que la v1 publica hoy.

Dirección

Toda llamada de la v1 va a esta dirección:

https://api.fatureihoje.com/public/v1

Autenticación

La clave se crea en el panel, en Configuración, y viaja en la cabecera Authorization:

Authorization: Bearer fh_live_tu_clave

Cada clave lleva solo los permisos elegidos al crearla. Guarda la clave en tu servidor: no debe aparecer en el navegador ni dentro de una aplicación instalada en el teléfono de tu cliente.

La cabecera Accept-Language elige el idioma de los mensajes de error. El código del error, los nombres de los campos y las rutas son iguales en cualquier idioma.

Primera llamada

GET /me responde de quién es la clave: la empresa, los permisos concedidos y los límites de uso. Es la llamada adecuada para confirmar que la clave es válida antes de escribir cualquier integración.

curl https://api.fatureihoje.com/public/v1/me \
  -H "Authorization: Bearer fh_live_tu_clave" \
  -H "Accept-Language: es"

La Referencia lista las rutas publicadas, con los campos de cada respuesta y los errores que cada una puede devolver.