POST
Pedirle al conector un recurso del proveedor

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.

Encabezados

X-Provider-Access-Token
string
requerido

El token del merchant contra el proveedor. Viaja sólo en el header y nunca en el cuerpo, para que no termine en un log de request ni en un archivo de crudos.

Minimum string length: 1

Cuerpo

application/json

connectorprotocol.FetchRequest. O una lectura individual (external_id) o una paginada (page_size), nunca las dos ni ninguna: Validate() exige exactamente una. El token del merchant va en X-Provider-Access-Token, nunca en el cuerpo.

connection_id
string
requerido
Minimum string length: 1
provider_app_id
string
requerido
Minimum string length: 1
external_store_id
string
requerido
Minimum string length: 1
resource
enum<string>
requerido

Los tres recursos que sabe cargar el bootstrap (connectorprotocol.Resource).

Opciones disponibles:
products,
taxonomy,
orders
external_id
string
requerido
Minimum string length: 1
cursor
string
Minimum string length: 1
page_size
integer
Rango requerido: 1 <= x <= 250
created_at_min
string<date-time>

Sólo válido para orders; con otro recurso es un error del cliente.

Respuesta

El recurso, o una página de recursos.

body para una lectura individual, items para una página. El conector devuelve el JSON del proveedor sin tocar: normalizarlo acá sería una diferencia silenciosa con lo que archivamos.

done
boolean
requerido
body
any

El recurso tal como lo devolvió el proveedor.

items
any[]
next_cursor
string
Minimum string length: 1