Saltar al contenido

Primeros pasos

Inicio rápido

De tu API key a tu primera respuesta JSON, paso a paso.

01Prepara tu API key

Crea tu cuenta, confirma tu correo y genera una clave desde el panel de API keys. Si ya tienes una cuenta, inicia sesión para acceder al panel.

Ir a mis API keys
Variable de entornobash
export ECUADORAPI_KEY="ecu_tu_api_key"

Reemplaza ecu_tu_api_key por tu clave real. Guárdala en el entorno de tu servidor.

02Explora la demo o prepara tu saldo

El playground muestra respuestas y errores con datos ficticios, sin usar tu clave ni consumir saldo. Para enviar una petición real, elige un endpoint y revisa su tarifa. Recarga si requiere saldo.

Explorar demo con datos ficticios

03Consulta un endpoint de datos

Este ejemplo consulta nombres y apellidos por cédula. Reemplaza la cédula ficticia de la URL por un número de 10 dígitos y revisa el precio antes de ejecutarlo.

Ver precio y referencia de este endpoint
Solicitud cURLbash
curl "https://api.ecuadorapi.com/api/v1/cedulas/1700000000/nombres" \
  -H "Authorization: Bearer $ECUADORAPI_KEY"

Ejecuta desde tu terminal. Configura ECUADORAPI_KEY en el entorno. Nunca publiques tu clave en el navegador.

URL base de todos los endpointstext
https://api.ecuadorapi.com/api/v1

04Usa la respuesta en tu aplicación

Datos ficticios. La respuesta real depende del registro consultado.

Respuesta JSON de ejemplojson
{
  "data": {
    "id": "1700000000",
    "full_name": "PÉREZ GARCÍA JUAN ANDRÉS",
    "first_name": "JUAN ANDRÉS",
    "last_name": "PÉREZ GARCÍA"
  },
  "error": null,
  "message": null
}
data
Contiene el resultado. Los ejemplos de JavaScript, Python y PHP lo guardan en data. Su estructura depende del endpoint.
error
Indica si ocurrió un error. Revisa también el estado HTTP.
message
Explica el resultado o el error; puede ser null.

Ya tienes lo esencial.

Encuentra los datos que necesita tu aplicación.

Explorar endpoints