Ir al contenido
Chequea Docs

Autenticación

Esquema usado

Sección titulada «Esquema usado»

La API usa autenticación por bearer token:

Authorization: Bearer ak_live_...

Tipos de clave

Sección titulada «Tipos de clave»
  • ak_live_... para integraciones reales
  • ak_test_... para entornos de prueba cuando aplique

Scopes

Sección titulada «Scopes»

Cada endpoint puede requerir uno o más scopes específicos, por ejemplo:

  • ruc:read
  • tipo-cambio:read
  • cpe:validate

Si una clave no tiene los scopes necesarios, la API responderá con 401 o 403 según el caso.

Buenas prácticas

Sección titulada «Buenas prácticas»
  • usa una clave distinta por integración relevante
  • limita scopes cuando una integración no necesita acceso total
  • no expongas claves API en frontend público
  • rota claves cuando sospeches exposición

Ejemplo mínimo

Sección titulada «Ejemplo mínimo»
Ventana de terminal
curl --request GET \
  --url https://api.chequea.pe/api/v1/tipo-cambio \
  --header 'Authorization: Bearer ak_live_TU_CLAVE'