Un contrato estable
Envía una intención funcional con un identificador de solicitud. Evita acoplar tu lógica directamente a una variante regional del proveedor de red.
APIs CAMARA · Open Gateway
Una superficie única para integrar señales de red.
Capacidades CAMARA y GSMA Open Gateway con control de habilitaciones (Entitlements), credenciales de prueba aisladas y evidencia técnica verificable.
API request
SANDBOX
number-verification
{
"requestId": "req_test_example",
"status": "completed",
"result": {
"verified": true,
"source": "network"
}
}Modelo de integración
Del estándar de red a una decisión de producto
Conecta2 expone una capa de acceso única para consumir capacidades de red, normalizar contratos y asociar cada solicitud a un proyecto, una habilitación (Entitlement) y una referencia de consentimiento. La cobertura y los perfiles disponibles dependen de cada mercado y deben confirmarse antes de una integración productiva.
Habilitación vigente
Cada operación se evalúa contra la habilitación (Entitlement) del proyecto, su alcance y las políticas de uso configurables.
Resultado trazable
La respuesta conserva un identificador de correlación y referencia las políticas y consentimientos aplicados, sin exponer secretos.
Implementación configurable
Las versiones CAMARA, las correspondencias de GSMA Open Gateway, los finales de cada ambiente y las políticas de retención, consentimiento y tratamiento de datos se publican como configuración versionada. Estado: [por validar]
Catálogo inicial
Capacidades CAMARA / Open Gateway
Esta taxonomía define el modelo comercial y técnico de acceso. No implica que todas las capacidades estén disponibles en todos los países, contratos o ambientes. Confirma cobertura y disponibilidad en el portal antes de iniciar una integración.
| Capacidad | Intención funcional | Resultado esperado | Estado |
|---|---|---|---|
| Number Verification | Comprobar el control actual de una línea móvil en la red. | Confirmación booleana de verificación. | [por validar] |
| Device Swap Status | Evaluar la vigencia de la asociación entre un dispositivo y la suscripción móvil. | Indicador del estado de cambio, sujeto a la ventana de frescura del contrato. | [por validar] |
| Device Location | Obtener una ubicación derivada de la red cuando la capacidad esté habilitada. | Coordenadas, precisión y momento de observación; no equivale a localización exacta. | [por validar] |
| Device Roaming Status | Consultar condiciones de itinerancia de una línea en la red disponible. | Estado y condiciones aplicables; no implica seguimiento continuo. | [por validar] |
| Connectivity Parameter | Consultar parámetros de conectividad de un servicio dentro del alcance configurado. | Datos técnicos según la variante regional y la versión del estándar. | [por validar] |
| QoS Profiles | Solicitar un perfil de calidad de servicio donde exista soporte de red. | Perfil solicitado y estado de activación, sujeto a elegibilidad técnica. | [por validar] |
Los nombres representan capacidades CAMARA y Open Gateway. La equivalencia comercial, la versión normativa y el contrato expuesto por Conecta2 se publican en la documentación del portal: [por validar]
Ejemplo request / response
Una integración creada para ser verificable
El siguiente intercambio es ilustrativo y no sustituye el contrato OpenAPI publicado para tu proyecto. Los identificadores, el host y los campos obligatorios deben tomarse de la versión asignada al ambiente sandbox.
1
Autenticar
2
Validar habilitación
3
Consultar red
4
Registrar evidencia
Solicitud
SANDBOX
POST [BASE_URL_SANDBOX]/v1/number-verification/verify HTTP/1.1
Host: [HOST_SANDBOX]
Authorization: Bearer [ACCESS_TOKEN_DE_PRUEBA]
Content-Type: application/json
Idempotency-Key: test-[UUID]
X-Project-Id: [PROJECT_ID]
{
"phoneNumber": "+56[NUMERO_DE_PRUEBA]",
"entitlementId": "[ENTITLEMENT_ID]",
"consentReference": "[CONSENT_REFERENCE]"
}La normalización, el hash y los campos obligatorios dependen de la versión del contrato y del mercado: [por validar]. Nunca utilices datos personales reales en ejemplos compartidos.
Respuesta
EJEMPLO
HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: req_test_[ID]
{
"requestId": "req_test_[ID]",
"data": {
"devicePhoneNumberVerified": true
}
}Una respuesta válida puede indicar un resultado negativo dentro del campo de negocio. Los errores de autenticación, autorización, validación o disponibilidad se representan según el OpenAPI asignado: [por validar].
| Clase | Ejemplo de código | Tratamiento recomendado |
|---|---|---|
| Solicitud | INVALID_REQUEST |
Corregir el payload contra el OpenAPI; no reintentar sin modificar la solicitud. |
| Acceso | UNAUTHORIZED |
Verificar el token de sandbox y el proyecto asociado. |
| Habilitación | ENTITLEMENT_NOT_ACTIVE |
Revisar alcance, vigencia y autorización del proyecto antes de reintentar. |
| Límite | RATE_LIMIT_EXCEEDED |
Aplicar backoff y respetar las políticas publicadas para el ambiente. |
| Proveedor | UPSTREAM_UNAVAILABLE |
Reintentar únicamente si la operación es idempotente y la política lo permite. |
Claves de prueba
Credenciales aisladas por proyecto y ambiente
Las claves de prueba se emiten desde el portal único. Conecta2 no publica una credencial compartida: cada proyecto recibe identificadores propios y el acceso queda limitado a las capacidades autorizadas.
SIN SECRETOS EN EL REPOSITORIO
Variables para un cliente de servidor
CONECTA2_BASE_URL="[BASE_URL_SANDBOX]"
CONECTA2_TOKEN_URL="[TOKEN_URL_SANDBOX]"
CONECTA2_CLIENT_ID="[CLIENT_ID_DE_PRUEBA]"
CONECTA2_CLIENT_SECRET="[CLIENT_SECRET_DE_PRUEBA]"
CONECTA2_PROJECT_ID="[PROJECT_ID]"
CONECTA2_ENTITLEMENT_ID="[ENTITLEMENT_ID]"Todos los valores son marcadores. No incluyas claves reales en código cliente, ejemplos, tickets, registros o capturas.
CICLO DE VIDA
Controles mínimos
- Emitir credenciales separadas para sandbox y producción.
- Conservar secretos en un gestor seguro del lado del servidor.
- Rotar y revocar credenciales ante cualquier exposición.
- Limitar cada clave a los proyectos y scopes autorizados.
- Conservar trazas de emisión, uso, rotación y revocación.
Mecanismo de emisión, expiración y revocación: [por validar].
Entorno no productivo
Sandbox sirve para validar contratos e integraciones. No representa disponibilidad productiva, calidad de red, SLA ni precios. Estado: [porvalidar].
Habilitaciones (Entitlements)
El acceso y el cobro comparten el mismo control
Cada proyecto opera contra una habilitación (Entitlement) explícita. El servicio valida la capacidad solicitada, el ambiente, la vigencia y el consumo antes de ejecutar la operación. Las tarifas y unidades de cobro son configurables y permanecen [por validar].
| Dimensión | Control | Estado |
|---|---|---|
| Proyecto | Aísla credenciales, solicitudes y trazabilidad. | Definido |
| Capacidad | Limita las APIs CAMARA / Open Gateway habilitadas. | Definido |
| Ambiente | Separa pruebas de producción. | Definido |
| Vigencia | Vincula el acceso a la política comercial aplicable. | [por validar] |
| Unidad de consumo | Representa el uso facturable según la tarifa configurada. | [por validar] |
| Límites técnicos | Define cuotas, concurrencia y políticas de reintento por ambiente. | NO MEDIDO |
Alcance mínimo
La clave de un proyecto no habilita capacidades no autorizadas. La ampliación requiere autorización y registro de la nueva versión contractual.
Evidencia de consumo
Cada operación conciliable conserva proyecto, habilitación, request ID y estado. Los detalles de retención son configurables.
Cambio controlado
Suspender o revocar una habilitación bloquea nuevas ejecuciones sin eliminar el historial sujeto a política.
Camino a producción
Gates técnicos, legales y operativos
El paso a producción exige una revisión explícita. Las políticas regulatorias y de tratamiento de datos son configurables por jurisdicción, finalidad, capacidad y versión.
Validación de contrato
- OpenAPI y versión de cada capacidad confirmados.
- Esquemas de request, response y error verificados.
- Idempotencia, correlación y reintentos definidos.
- Normalización y hash de identificadores confirmados.
Validación de uso
- Finalidad y base de consentimiento aprobadas.
- Retención y eliminación configuradas.
- Registro de acceso y minimización de datos revisados.
- Habilitaciones, límites y alertas operativas aplicados.
Métricas no declaradas
Disponibilidad, latencia, capacidad por región, cuotas y SLA no se presentan como compromisos hasta ser medidos y aprobados: NO MEDIDO.
Portal único
Un punto de acceso para comenzar
Desde el portal de developers puedes solicitar el proyecto sandbox, generar claves de prueba, consultar documentación versionada y revisar las habilitaciones asociadas.
Entrar al portal Solicitar piloto
Disponibilidad de registro, onboarding y dominios de credenciales: [por validar].