Autenticación

Aprende cómo autenticarte con la API de Fibek usando una API Key.

Fibek usa una API Key por empresa para autenticar las llamadas a la API. La API Key se envía en el encabezado X-API-KEY. Por defecto no expira —opcionalmente puede fijarle una fecha de vencimiento al crearla— y se deshabilita revocándola.

Generación de una API Key

Puede crear su API Key directamente desde la plataforma Fibek. Necesita ser administrador del equipo de su empresa:

Inicie sesión en su cuenta de Fibek
Navegue a Mi Compañía → Integraciones
Abra la pestaña Integración por API
En el panel API Keys, haga clic en Crear API Key y asígnele un nombre
Copie y guarde de forma segura la API Key generada

Importante: la API Key se muestra una sola vez. No se puede recuperar después; si la pierde, cree una nueva.

Use la key de esta pestaña. Las API Keys creadas en la pestaña de Siigo Pyme sirven solo para ese flujo: con ellas los endpoints de carga CSV responden 403.

Información de la API Key

Al crearla recibirá:

Campo	Tipo	Descripción
`id`	Number	Identificador de la API Key, para listarla o revocarla
`name`	String	El nombre que usted le asignó
`key`	String	La API Key (empieza con `fbk_live_`). Solo se muestra en este momento
`keyPrefix`	String	Los primeros caracteres de la key, para reconocerla en el listado
`createdAt`	Date	Fecha de creación

En el listado de la pestaña Integración por API verá el prefijo, el estado (activa, expirada o revocada) y la fecha del último uso — nunca la key completa.

Uso de la API Key

Incluya la API Key en el encabezado X-API-KEY en todas las solicitudes:

X-API-KEY: <SU_API_KEY>

Ejemplo:

curl -X POST "https://backend.fibek.co/full-csv-integration/upload-customers" \
  -H "X-API-KEY: <SU_API_KEY>" \
  -F "customersFile=@customers.csv"

Revocación

Para deshabilitar una API Key, use Revocar en la pestaña Integración por API. Cualquier integración que la esté usando deja de funcionar de inmediato y las llamadas con esa key responden 401. Para rotarla, cree una nueva y revoque la anterior cuando ya no se use.