Ir al contenido

Beta privada · apertura 23 de diciembre

Lista tus conexiones

GET /v1/conecta/conexiones

Conexiones de la cuenta con su canal, proveedor y estado.

Dato Valor
Permiso conecta:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP conexion_listar (Próximamente)
Nombre En Requerido Tipo Descripción
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
canal query No string
estado query No string
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/conecta/conexiones" \
-H "Authorization: Bearer onx_test_…"

Página de conexiones.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].id string Sí Identificador que empieza con con_.
elementos[].proveedor “zernio” | “ycloud” | “meta” Sí Por dónde sale la conexión. Puedes pasar un número de un proveedor a otro sin cambiar tu integración.
elementos[].canal “whatsapp” | “instagram” | “messenger” Sí
elementos[].nombre string Sí
elementos[].estado “pendiente” | “activa” | “desconectada” | “error” Sí
elementos[].telefono string | null Sí
elementos[].cuenta string | null Sí Usuario de Instagram o página de Facebook, si aplica.
elementos[].alta_url string (uri) | null Sí Mientras está pendiente: dónde termina el alta una persona.
elementos[].creada_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
elementos[].ultima_prueba_en string (date-time) | null Sí
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

Cada código tiene su explicación en Errores.