Quickstart

Primera consulta en 5 minutos. Sigue estos cinco pasos y obtendrás tu primera respuesta de la API.

1. Crea tu cuenta

Regístrate gratis en /signup. Solo necesitas un correo electrónico válido. El plan Demo está disponible al instante sin tarjeta de crédito.

2. Genera tu API key

Ingresa al panel y dirígete a /dashboard/keys. Haz clic en "Nueva key", asigna un nombre descriptivo (por ejemplo, backend-produccion) y guárdala en un lugar seguro. La key solo se muestra una vez.

3. Tu primera consulta con curl

Reemplaza TU_API_KEY por tu key y ejecuta:

curl -X GET "https://apisperu.gsalinas.site/api/ruc?numero=20100047218" \
  -H "Authorization: Bearer TU_API_KEY"

4. Ejemplo en JavaScript

Desde Node.js o cualquier runtime con fetch:

const res = await fetch(
  'https://apisperu.gsalinas.site/api/ruc?numero=20100047218',
  {
    headers: {
      Authorization: 'Bearer TU_API_KEY',
    },
  }
);

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

5. Errores comunes

Si recibes un código distinto a 200, revisa nuestra guía de errores. Los más frecuentes son 401 (key inválida o ausente), 429 (límite excedido) y 400 (parámetros inválidos).