Documentación Oficial

Gateway Api

Documentación completa para integraciones con API de Gateway 2. Incluye referencia OpenAPI y ejemplos listos para usar en Node.js y Python.

Ver referencia completa Ver ejemplos por endpoint

44

Operaciones

34

Rutas API

OAuth2 JWT

Autenticación requerida

URL base

La URL base se entrega por canal privado. Configúrela en GATEWAY2_BASE_URL antes de usar los ejemplos.

Headers obligatorios

Authorization: Bearer <JWT_VALIDO>
Content-Type: application/json

Convención de respuesta

La API suele responder HTTP 200 incluso ante errores funcionales. Validar siempre:

{
  "resultado": "OK" | "FAIL",
  "motivo": "..." // cuando resultado = FAIL
}

Quickstart Node.js

import axios from 'axios';

const api = axios.create({
  baseURL: process.env.GATEWAY2_BASE_URL,
  headers: { Authorization: `Bearer ${process.env.GATEWAY2_TOKEN}` }
});

const { data } = await api.get('/bcp1/servicers', { params: { tipo: 'mhe' } });
console.log(data);

Quickstart Python

import os
import requests

r = requests.get(
    f"{os.environ['GATEWAY2_BASE_URL']}/bcp1/servicers",
    headers={'Authorization': f"Bearer {os.getenv('GATEWAY2_TOKEN')}"},
    params={'tipo': 'mhe'},
    timeout=60
)
print(r.json())