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 requiere uno o más scopes específicos:

  • ruc:read — consulta RUC individual y en lote
  • ubigeos:read — consulta de catálogo de ubigeos
  • tipo-cambio:read — tipo de cambio BCRP
  • cpe:validate — validación de comprobantes electrónicos SUNAT

Si una clave no tiene los scopes necesarios, la API responderá con 401 o 403 según el caso. Pide los scopes mínimos que tu integración requiera.

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'