Servicio REST de Consulta CURP - RENAPO
Información General
INFORMACIÓN
Propósito: Este documento describe la integración con el servicio REST de RENAPO para la consulta de datos de CURP (Clave Única de Registro de Población) en el proyecto Comunes.
Endpoints del Servicio
bash
GET http://lbint-devl.procesar.net/comunesPulssar/renapo/curp/{CURP}bash
GET http://192.168.1.61/comunesPulssar/renapo/curp/{CURP}Configuración General:
- Método: GET
- Protocolo: HTTP/REST
- Encoding: UTF-8
- Formato de respuesta: JSON
Parámetros
| Parámetro | Tipo | Ubicación | Requerido | Descripción |
|---|---|---|---|---|
| CURP | String | Path | Sí | CURP de 18 caracteres a consultar |
Ejemplos de Solicitud
bash
GET http://lbint-devl.procesar.net/comunesPulssar/renapo/curp/GAHG551011MNERND02bash
GET http://192.168.1.61/comunesPulssar/renapo/curp/GAHG551011MNERND02CONSEJO
CURP de ejemplo: La CURP resaltada es válida para pruebas. Reemplázala con la CURP real que necesites consultar.
Response
Estructura de Respuesta
json
{
"CURP": "GAHG551011MNERND02",
"apellido1": "GARZA",
"apellido2": "HUNTER",
"nombres": "MARIA GUADALUPE",
"sexo": "M",
"fechNac": "11/10/1955",
"nacionalidad": "MEX",
"docProbatorio": "7",
"anioReg": "1958",
"foja": "",
"tomo": "",
"libro": "",
"numActa": "",
"CRIP": "",
"numEntidadReg": "",
"cveMunicipioReg": "",
"NumRegExtranjeros": "",
"FolioCarta": null,
"cveEntidadNac": "NE",
"cveEntidadEmisora": "",
"statusCurp": "RCN",
"curpHistoricas": [
"GAHG551011MDFRND06"
],
"resultadoOperacion": "01"
}CONSEJO
Datos principales: Las líneas resaltadas (2-5) contienen la información básica del ciudadano. Estos son los campos más utilizados en las validaciones.
Campos de Respuesta
Datos Principales
| Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| CURP | String | Clave Única de Registro de Población | GAHG551011MNERND02 |
| apellido1 | String | Primer apellido | GARZA |
| apellido2 | String | Segundo apellido | HUNTER |
| nombres | String | Nombres | MARIA GUADALUPE |
| sexo | String | Sexo (M=Mujer, H=Hombre) | M |
| fechNac | String | Fecha de nacimiento (DD/MM/YYYY) | 11/10/1955 |
| nacionalidad | String | Nacionalidad | MEX |
Datos de Registro
| Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| docProbatorio | String | Documento probatorio | 7 |
| anioReg | String | Año de registro | 1958 |
| statusCurp | String | Estatus de CURP | RCN |
| curpHistoricas | Array | CURPs anteriores | ["GAHG551011MDFRND06"] |
Metadatos de Operación
| Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| resultadoOperacion | String | Código de resultado | 01 |
Códigos de Error
| Código | Descripción | Acción |
|---|---|---|
| 01 | Operación exitosa | Continuar flujo normal |
| 02 | CURP no encontrada | Verificar CURP ingresada |
| 03 | Error en formato de CURP | Validar estructura de CURP |
| 99 | Error interno del servicio | Reintentar o contactar soporte |
Consideraciones de Implementación
ADVERTENCIA
Autenticación y Seguridad
- Implementar autenticación mediante tokens o certificados
- Utilizar HTTPS en producción
- Implementar rate limiting para prevenir abusos
- Registrar logs de consultas para auditoría
PELIGRO
Manejo de Errores
- Implementar manejo de errores HTTP (4xx, 5xx)
- Reintentar automáticamente para errores temporales
- Mostrar mensajes de error amigables al usuario
- Registrar errores para monitoreo y análisis
INFORMACIÓN
Validación de Datos
- Validar formato de CURP antes de enviar la petición
- Verificar respuesta completa antes de procesar
- Implementar validación de tipos de datos recibidos
Comparación con Servicio SOAP
| Característica | Servicio REST | Servicio SOAP |
|---|---|---|
| Protocolo | HTTP/REST | SOAP |
| Método | GET | POST |
| Formato | JSON | XML |
| Complejidad | Menor | Mayor |
| Rendimiento | Mayor | Menor |
| Caché | Fácil | Difícil |
Buenas Prácticas
Detalles
1. Caching
- Implementar caché para respuestas exitosas
- Establecer TTL adecuado según frecuencia de actualización
- Invalidar caché cuando se actualicen datos
Detalles
2. Monitoreo
- Registrar métricas de rendimiento
- Monitorear tasa de errores y tiempos de respuesta
- Configurar alertas para anomalías
Detalles
3. Seguridad
- Validar y sanitizar todos los parámetros de entrada
- Implementar throttling para prevenir ataques
- Cifrar datos sensibles en tránsito y reposo