Quickstart

1. Genera tu clave API

Obtén tu clave API desde el dashboard. Todas las solicitudes autenticadas usan el encabezado:

Authorization: Bearer ak_live_...

2. Haz tu primera consulta

curl --request GET \
  --url https://api.chequea.pe/api/v1/ruc/20100070970 \
  --header 'Authorization: Bearer ak_live_TU_CLAVE'

Si estás probando localmente:

curl --request GET \
  --url http://localhost:8080/api/v1/ruc/20100070970 \
  --header 'Authorization: Bearer ak_live_TU_CLAVE'

3. Interpreta la respuesta

Las respuestas exitosas usan application/json. Los errores públicos siguen una estructura uniforme con:

• type
• title
• status
• detail
• instance

4. Identifica el tipo de endpoint

• Endpoints directos: responden de inmediato
• Endpoints cacheados: responden con información ya normalizada

5. Siguiente paso recomendado

Después del primer request:

• revisa scopes requeridos por endpoint
• valida cómo tratar 400, 401 y 429
• confirma qué respuestas sirven desde caché y cuáles dependen de fuente externa

Consejo

Si vas a integrar varios endpoints, empieza por RUC o tipo de cambio. Son los más simples para validar autenticación, formato de errores y límites.