Autenticación

Autentica tus solicitudes a la API de Falconext con API keys por entorno.

La API de Falconext usa API keys para autenticar solicitudes. Cada key pertenece a un entorno y lleva un prefijo que indica su tipo.

Formato de la key

Prefijo	Entorno	Uso
`sk_test_…`	Sandbox	Pruebas, sin efectos reales
`sk_live_…`	Producción	Entregas reales

Trata tus keys como contraseñas

Nunca expongas una sk_live_ en el frontend, apps móviles o repositorios. Úsala solo en tu servidor. Si se filtra, revócala de inmediato desde la consola.

Autoriza tus solicitudes

Envía la key en la cabecera Authorization como Bearer token:

Terminal

curl https://api.falconext.pe/api/v1/logistics/orders \
  -H "Authorization: Bearer $FALCONEXT_API_KEY"

Una key ausente o inválida devuelve 401 Unauthorized:

JSON

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "La API key proporcionada no es válida."
  }
}

Entornos

Empieza en Sandbox

Usa una key sk_test_ contra https://api.falconext.pe/api/v1/logistics. Los pedidos son simulados y no generan costos ni movimientos reales.

Pasa a Producción

Cambia a una key sk_live_ y al host https://api.falconext.pe/api/v1/logistics. El resto de tu código no cambia.

Rotación de keys

Puedes tener varias keys activas para rotarlas sin downtime: crea una nueva, despliégala, y revoca la anterior cuando dejes de usarla.

Generar API Keys

Paso a paso para crear y administrar tus claves.