mobiconnect.dev · documentación pública

¿Cuánto tardas en hacer tu primera llamada gobernada?

Un quickstart con código real: pides un token, consultas Entitlements antes de llamar a la API CAMARA y lees la decisión.

entitlements/check · sandbox Ejemplo
allow · cuota disponiblenumber-verification · price_ref 0,008

Flujo de llamada

Ejemplo
1. authPOST /token
2. decisiónPOST /v1/entitlements/check
3. liberarPOST /v1/entitlements/release

Llamadas CAMARA

Ejemplo
allow Number Verification
x-correlator: 7f3a-91 price_ref 0,008
allow SIM Swap
x-correlator: 2c9d-44 price_ref 0,012
deny Device Location
x-correlator: a110-0e price_ref 0,015
lectura permitido / rechazado por cuota
Ejemplo Developer construyendo una integración contra la API de Entitlements
Portal developers

mobiconnect.dev

Documentación publicada. La API corre en un entorno de pruebas con datos simulados.

Alcance: el sandbox usa datos simulados; no hay tráfico de red ni dinero real en esta etapa.

El sandbox usa datos simulados, no tráfico ni dinero real.

Dominio mobiconnect.dev
Estado Publicado · API de pruebas
Estándar CAMARA (GSMA)
Idioma Español
Datos Sintéticos, sin dinero real
Quickstart

Tres pasos hasta tu primera decisión.

Lo que un integrador necesita para llegar a la primera respuesta de Entitlements, con código real contra el entorno de pruebas.

01 · Autenticar

Obtén un token

OAuth2 client_credentials. Tokens de una hora, con scopes explícitos por cliente.

POST /token
grant_type=client_credentials
client_id=…
client_secret=…
02 · Consultar

Pide la decisión

Antes de llamar a la API CAMARA, consultas Entitlements con el x-correlator de la transacción.

POST /v1/entitlements/check
Authorization: Bearer
atk_test_7f91c0…
x-correlator: 7f3a-91
03 · Liberar

Confirma o libera

Si la llamada de red falla después de la autorización, liberas la reserva de cuota con el mismo correlator.

POST /v1/entitlements/release
Idempotency-Key: 9c21-ab
x-correlator: 7f3a-91

token→check→release

Entitlements · respuesta

Una respuesta, dos lectores.

La misma respuesta sirve a una aplicación y a un agente AI: decisión determinista, razón en un enum cerrado, sin ambigüedad que interpretar.

POST /v1/entitlements/check → 200 Ejemplo
{
  "allow": true,
  "reason": "ok",
  "remaining_quota": 978,
  "plan_id": "operador_pro",
  "price_ref": "0.008",
  "x_correlator": "7f3a-91"
}

decisión determinista

allow / deny · deny-by-default, sin estados intermedios que adivinar.

razón en enum cerrado

ok · no_subscription · suspended · scope_denied · quota_exceeded

cuota restante y plan

Unidades disponibles, plan_id y price_ref en cada respuesta, sin llamada adicional.

aplicación y agente AI

El mismo contrato JSON lo consume un backend tradicional o un agente que decide en tiempo real.

Qué encuentras hoy

Tres piezas, un mismo contrato.

Lo que un integrador necesita para entender la primera decisión de Entitlements antes de escribir una línea de código.

01 · Referencia

La API, contrato por contrato

POST /v1/entitlements/check y /release, administración y salud: encabezados, cuerpo, razones de decisión y respuestas.

  • Razones de decisión en un enum cerrado
  • Errores con su semántica y qué hacer
  • Ejemplos sobre el entorno de pruebas, nunca datos reales
02 · Autenticación

OAuth2 hoy; claves con la consola

Hoy: OAuth2 client_credentials con tokens de una hora y scopes por cliente, sobre el entorno de pruebas. Las claves de prueba y de producción llegan con la consola del portal, en construcción.

  • OAuth2 client_credentials, tokens de una hora
  • Scopes explícitos por cliente
  • Producción se habilita con la apertura pública
03 · Conceptos

El contrato, antes del código

Planes y cuotas, decisiones de autorización, idempotencia y fail-closed, explicados antes de la primera llamada.

  • Deny-by-default: sin autorización explícita, no se sirve
  • Idempotency-Key en cada escritura con efecto económico
  • Fail-closed: si no se puede decidir, no se sirve
Principios

Un contrato es una promesa.

Cuatro reglas que gobiernan cómo documentamos, qué prometemos y qué no.

Regla 01

Cuota agotada no es error

Cuando el plan se agota, la API responde 200 con allow:false y la razón. El 429 pertenece al gateway, no al contrato. Predecibilidad primero.

Regla 02

Cero datos reales en la documentación

Los ejemplos corren en el entorno de pruebas, con tenants sintéticos y sin dinero real. Ningún dato de clientes aparece en material público.

Regla 03

El estado, dicho en voz alta

Cada API del portal declara su estado: en pruebas, en construcción o en diseño. No documentamos como disponible lo que no corre.

Regla 04

Lo que falta, por escrito

La consola de pruebas en el navegador, la versión en inglés y la conformidad CAMARA completa están en la hoja de ruta. Se anuncian cuando corran.

MCP · agentes AI

La misma decisión, llamada por un agente.

La respuesta determinista de Entitlements —reason en enum cerrado, allow/deny explícito— está pensada para que un agente AI la consuma sin ambigüedad, con el mismo contrato que usa una aplicación tradicional.

  • Razones de decisión legibles por máquina, sin texto libre
  • Idempotency-Key para que un agente reintente sin duplicar efecto
  • Un servidor MCP sobre Entitlements está en diseño
En diseño Agentes AI consumiendo decisiones de Entitlements junto a un equipo técnico
Clientes del contrato

Aplicaciones y agentes, bajo la misma regla

Cuota, presupuesto y permiso se gobiernan igual, sea quien llame un humano o un agente.

Academias

Formación técnica, no solo documentación.

Dos academias del grupo para developers que necesitan entender el problema antes de resolverlo con nuestra API.

A·01

Ingeniería de OTP segura

nviaotp.me

Cómo diseñar verificación por OTP que resista fraude, sin fricción innecesaria para quien se autentica de verdad.

Visitar academia
A·02

Arquitectura CPaaS

ub3r.io

Los componentes de una plataforma de comunicaciones programable: mensajería, voz y los contratos que las gobiernan.

Visitar academia
Equipo de developers evaluando el sandbox de Entitlements
Acceso anticipado

Entorno abierto, acceso guiado

Acceso anticipado

Construye con nosotros antes que nadie.

Estamos abriendo un grupo reducido de equipos para probar Entitlements en el entorno de pruebas. Si vendes o consumes una API como producto, hablemos.

El sandbox usa datos simulados; no hay dinero real ni tenants de producción en esta etapa.

Medir es gobernar

Pide acceso al sandbox antes del 15 de diciembre de 2026.

CAMARA ya resuelve la interfaz; aquí pruebas el contrato que decide quién tiene derecho a usarla, y a qué precio.