Empezar

Autenticación

Todas las peticiones al API Enterprise se autentican con un token Bearer en el header Authorization. El token identifica tu cuenta B2B y sus límites.

Token Bearer

Incluye el header en cada petición. Guarda el token como secreto en tu backend: no lo expongas en clientes (apps o navegadores).

Header de autenticación

curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/Test" \
  -H "Authorization: Bearer $FF_API_TOKEN"

Si el token es inválido o expiró, la API responde 401. En ese caso solicita al equipo la renovación de tus credenciales.

Token inválido o expirado

HTTP/1.1 401 Unauthorized

Cómo solicitar acceso

El API Enterprise se habilita por cuenta, con límites y volumen acordados. Agenda una demo con el equipo: revisamos tu caso de uso y te entregamos credenciales de integración.

Agendar demo

El envelope FFResponse

Todas las respuestas del API comparten la misma estructura. isSuccess y message siempre están presentes; data depende del endpoint.

Campo	Tipo	Descripción
`isSuccess`	boolean	Indica si la operación fue o no exitosa.
`message`	string	Mensaje informativo del estado de la petición: confirmación de éxito o la razón de una operación fallida.
`data`	object \| array \| null	Información solicitada. Depende del endpoint: algunos no regresan data.

Estructura de toda respuesta

{
  "data": { },
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

Códigos HTTP

Código	Descripción
`200`	Petición correcta.
`400`	Parámetros incorrectos.
`401`	Token de autenticación no válido o expirado.
`404`	No encontrado.
`500`	Fallo en el servidor.

Los errores de negocio (p. ej. un ticket ilegible) no son errores HTTP: la petición responde 200 y el resultado se comunica con isSuccess, message y los códigos de ticket.