POST
Dar de alta una conexión de conector custom

Autorizaciones

Authorization
string
header
requerido

El conector de plataforma y el operador. Registra conexiones, entrega webhooks, corre la saga de instalación y da de alta conexiones custom. Es el único principal obligatorio del proceso: los otros tres se apagan dejando su token vacío, y una puerta que no se monta no la abre ningún token.

Cuerpo

application/json

La pide el principal connector de operador, no el custom: el token de un conector custom nace de este alta y sólo sirve para su propia conexión.

external_store_id
string
requerido

Lo elige el conector; único por provider. Repetir el alta con el mismo valor es 409 connection_exists, no un alta silenciosa que emitiría un segundo token para la misma tienda.

Minimum string length: 1
display_name
string
Minimum string length: 1
country
string
Pattern: ^[A-Z]{2}$
currency
string
Pattern: ^[A-Z]{3}$
language
string
Pattern: ^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$

Respuesta

La conexión y su token. El token se muestra una sola vez; del lado del servidor queda su hash.

connection_id
string
requerido
Pattern: ^cn_.+
token
string
requerido

Se muestra una sola vez; del lado del servidor queda su hash. Un token pertenece a una conexión: usado contra otra, o contra una ruta de otro principal, es 401 sin decir por qué.

Pattern: ^cct_.+