Saltar al contenido

API DE REVÍSAME. Verificación de solicitantes de arrendamiento para plataformas socias. Revísame informa; el arrendador decide.

Revísame / desarrolladores

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.

AsíncronaJSON / HTTPSSandboxWebhook firmadoCanal MCP
Probar en vivo →SandboxVer endpoints

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

  1. 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"}
  2. Crea la verificación

    Genera un solicitud_id único y opaco (un UUID) y úsalo también como Idempotency-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 }
    }
  3. Obtén el resultado

    Consulta hasta que el estado sea emitida o no_concluyente (suele tardar unos minutos), o espera el webhook verificacion.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