Inicio rápido · 00
Verifica solicitantes desde tu plataforma.
Una llamada crea la verificación; minutos después recibes una recomendación para el arrendador, con su sustento documental y sin exponer el reporte crudo de las fuentes.
La API de Revísame le permite a tu plataforma (el socio) pedir la verificación de un solicitante de arrendamiento y recibir una recomendación para el arrendador: una acción sugerida con su sustento documental. Revísame informa; el arrendador decide.
Base de la API
https://rab-api-production.up.railway.app
Formato
JSON sobre HTTPS, esquema cerrado, códigos de error estables.
Asíncrona
La verificación nace en_proceso y se resuelve en minutos.
Para agentes
Conéctala a Claude u otro cliente con el canal MCP.
Antes de empezar
- Una llave de socio (te la entrega Revísame por un canal seguro). Ver Autenticación.
- El consentimiento expreso del solicitante, recabado por tu plataforma. Ver Privacidad y consentimiento.
- La CURP del solicitante. Hoy la API atiende la Ruta CURP; la ruta con documento (INE) está reservada.
Tres pasos
-
Prepara tu terminal y comprueba el servicio
export RAB="https://rab-api-production.up.railway.app" export RAB_LLAVE="<tu llave de socio>" # nunca la subas a un repositorio curl "$RAB/_salud" # {"estado": "arriba", "base": "alcanzable"} -
Crea la verificación
Genera un
solicitud_idúnico y opaco (un UUID) y úsalo también comoIdempotency-Key.SOLICITUD=$(uuidgen | tr 'A-Z' 'a-z') curl -X POST "$RAB/v1/verificaciones" \ -H "Authorization: Bearer $RAB_LLAVE" \ -H "Idempotency-Key: $SOLICITUD" \ -H "Content-Type: application/json" \ -d '{ "solicitud_id": "'"$SOLICITUD"'", "solicitante": { "curp": "<CURP del solicitante>" }, "consentimiento": { "otorgado": true, "otorgado_en": "2026-09-22T16:05:00-06:00", "version_aviso": "aviso-2026-09", "evidencia_id": "ev-000123" }, "webhook_url": "https://tu-dominio.mx/revisame/eventos" }'Responde de inmediato con HTTP 200 y la verificación
en_proceso:{ "verificacion_id": "<id>", "solicitud_id": "7f3c2a9e-…", "estado": "en_proceso", "consentimiento": { "consentimiento_id": "<id>" }, "cobro": { "estatus": null, "modo": "consumo", "monto": null, "moneda": null } } -
Obtén el resultado
Consulta hasta que el estado sea
emitidaono_concluyente(suele tardar unos minutos), o espera el webhookverificacion.emitida.curl "$RAB/v1/verificaciones/$VERIFICACION_ID" \ -H "Authorization: Bearer $RAB_LLAVE"{ "verificacion_id": "<id>", "estado": "emitida", "recomendacion": { "accion": "continuar_con_reservas", "mensaje": "…", "sustento_documental": { "nivel": "medio", "microexplicacion": "Indica qué tan completa y consistente es la información que respalda esta recomendación. No califica a la persona.", "factores": [ { "codigo": "IDENTIDAD_CONFIRMADA", "efecto": "fortalece", "texto": "…" }, { "codigo": "COBERTURA_FUENTES_PARCIAL", "efecto": "limita", "texto": "…" } ] } }, "cobertura_fuentes": { "consultadas": 2, "disponibles": 3 }, "cobro": { "estatus": "cargada", "modo": "consumo", "monto": 350.0, "moneda": "MXN" }, "vigencia_hasta": "…" }Los valores son ilustrativos. La forma exacta está en la referencia.
Siguientes pasos
- Ciclo de vida asíncrono: estados, sondeo y tiempos.
- Acciones y su significado: cómo mostrar la recomendación sin sobreprometer.
- Webhooks: verifica la firma antes de confiar en un evento.
- Errores: programa contra el
codigo, no contra el mensaje.