Primeros pasos
- Revisa el catálogo de APIs y sus requisitos.
- Solicita acceso según tu tipo de institución.
- Tras la aprobación, genera tus API Keys en el Panel de desarrolladores.
- Realiza tu primera llamada usando el ejemplo de cada API.
Autenticación
Todas las peticiones requieren una API Key válida en el encabezado Authorization con el esquema Bearer. Las llamadas sin credencial válida responden 401 Unauthorized.
La comunicación es únicamente sobre HTTPS. No compartas tu API Key ni la incluyas en código del lado del cliente.
Peticiones
Las APIs siguen un estilo REST y responden en JSON. El dominio base es:
Ejemplo de una consulta:
Límites de consumo
Cada credencial tiene un límite de consultas asignado según el convenio de acceso. La respuesta incluye tu saldo:
consultas_usadas— consultas realizadas en el periodo.consultas_restantes— disponibles antes de alcanzar el límite.limite_consultas— tope asignado a tu credencial.
Al superar el límite, las peticiones responden 429 Too Many Requests.
Errores
Los errores usan códigos HTTP estándar y un cuerpo JSON con el detalle en el campo error.
| Código | Significado |
|---|---|
200 | Consulta exitosa. |
400 | Parámetro inválido o mal formado. |
401 | API Key ausente o inválida. |
404 | Registro no encontrado. |
429 | Límite de consultas superado. |
503 | Fuente oficial no disponible temporalmente. |
APIs disponibles
Consulta la referencia detallada de cada endpoint en el catálogo:
- API CURP —
GET /v1/identidad/curp/{curp} - API RFC —
GET /v1/identidad/rfc/{rfc} - API RENAPO —
GET /v1/identidad/renapo/{curp} - API Cédula Profesional —
GET /v1/educacion/cedula/{cedula} - API REPUVE —
GET /v1/vehicular/repuve/{niv}