Cédula Paraguay API — Documentación interna

Servicio REST en PHP que devuelve el nombre asociado a una cédula de identidad paraguaya.

No incluye datos de padrón electoral (local de votación, mesa, fecha de nacimiento) — no existe una fuente pública para eso. Ver sección "Fuente de datos".

Fuente de datos

Única fuente disponible: turuc.com.py (tercero NO oficial, sin auth ni SLA documentado). En Paraguay el RUC de una persona física es la cédula + dígito verificador, y turuc.com.py resuelve por número de documento solo — por eso sirve como consulta de cédula.

Se investigaron y descartaron como fuente:

No usar para nada con implicancia legal. Si en el futuro aparece un acceso oficial (ej. convenio con el TSJE), migrar a esa fuente.

Autenticación

Todas las requests requieren el header:

Authorization: Bearer <TOKEN>

Token del servicio:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Está definido en config/config.php (clave service_token) o vía variable de entorno CEDULA_SERVICE_TOKEN (tiene prioridad sobre el valor del archivo). Sin el header correcto, la API responde 401.

Endpoints

MétodoRutaDescripción
GET/cedula/{cedula}Nombre y estado asociados a la cédula.

Formato de respuesta

{
  "ok": true,
  "fuente": "turuc.com.py",
  "cedula": "6589482",
  "encontrado": true,
  "nombre": "CONCHINEL, ANDRE LUIZ",
  "estado": "ACTIVO",
  "detalle": { ... datos crudos de la fuente ... }
}

Si la cédula no existe: "encontrado": false, "nombre": null. Si falla la fuente: HTTP 502 con {"ok": false, "error": "upstream", "errores": {"turuc.com.py": "..."}}.

Ejemplos con curl

curl -s -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://api.avatar.com.py/cedula/6589482"

Estado conocido / quirks