istmobot
ContenidoIntroducción

Documentación de istmobot API

Una API REST para leer documentos panameños y consultar registros públicos. Envías un archivo o un valor, recibes JSON con los mismos campos siempre.

Paso 1

Crea tu API key

Escríbenos para abrir tu cuenta y genera una key en el panel. Empiezas con una key de prueba y una de producción.

Paso 2

Haz tu primera llamada

Sigue Tu primera llamada: un curl con un comprobante Yappy y la respuesta explicada.

Paso 3

Pasa a producción

Cambia la key ib_test_ por ib_live_. Revisa créditos y límites.

Cómo está organizada la API

Hay dos tipos de endpoint. Los de documento reciben un archivo por multipart/form-data y lo leen. Los de consulta reciben un valor en la URL y buscan en la fuente oficial.

TipoMétodoEjemploCosto
DocumentoPOST/v1/yappy2 – 3 créditos
ConsultaGET/v1/factura/{cufe}1 crédito

Endpoints disponibles

Comprobante YappyPOST /v1/yappyExtrae los datos del comprobante Yappy y verifica que el pago se recibió.Factura electrónica DGIPOST /v1/facturaConsulta la factura electrónica en la DGI, por CUFE o desde el documento.Aviso de OperaciónPOST /v1/aviso-operacionExtrae los datos del Aviso de Operación.Cédula panameñaPOST /v1/cedulaExtrae los datos de la cédula panameña.Recibo ENSAPOST /v1/recibo-ensaExtrae los datos del recibo de ENSA.Recibo NaturgyPOST /v1/recibo-naturgyExtrae los datos del recibo de Naturgy.Recibo IDAANPOST /v1/recibo-idaanExtrae los datos del recibo de IDAAN.Estado de cuenta PanapassPOST /v1/panapassExtrae los datos del estado de cuenta Panapass.

Formato de respuesta

Toda respuesta exitosa tiene data (el resultado del endpoint) y meta (request_id, créditos usados, versión del endpoint y si fue sandbox). Los errores siguen RFC 7807.

{
  "data": { ... },
  "meta": {
    "request_id": "3f9c…",
    "credits_used": 2,
    "plugin_version": "1.0.0",
    "sandbox": false
  }
}
¿Prefieres probar sin escribir código? Abre el explorador interactivo: pega tu key y ejecuta cada endpoint desde el navegador.