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'

// Node 18+ (fetch built-in). Para Node 16 usa node-fetch o axios.
const apiKey = process.env.CHEQUEA_API_KEY

const res = await fetch("https://api.chequea.pe/api/v1/ruc/20100070970", {
  headers: { Authorization: `Bearer ${apiKey}` }
})

if (!res.ok) {
  const error = await res.json()
  throw new Error(`${error.type}: ${error.detail ?? error.title}`)
}

const data = await res.json()
console.log(data.razonSocial)

# pip install requests
import os
import requests

api_key = os.environ["CHEQUEA_API_KEY"]

res = requests.get(
    "https://api.chequea.pe/api/v1/ruc/20100070970",
    headers={"Authorization": f"Bearer {api_key}"},
    timeout=10,
)

if res.status_code != 200:
    err = res.json()
    raise RuntimeError(f"{err['type']}: {err.get('detail') or err['title']}")

data = res.json()
print(data["razonSocial"])

<?php
// PHP 8+ con cURL habilitado
$apiKey = getenv('CHEQUEA_API_KEY');

$ch = curl_init('https://api.chequea.pe/api/v1/ruc/20100070970');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $apiKey],
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);

if ($status !== 200) {
    throw new RuntimeException(
        ($data['type'] ?? 'error') . ': ' .
        ($data['detail'] ?? $data['title'] ?? 'request failed')
    );
}

echo $data['razonSocial'];

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