Saltar al contenido principal
WEBHOOK

Autorizaciones

Authorization
string
header
requerido

Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como Authorization: Bearer <key>. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como inventory:read o sales:write. Una clave con * tiene todos los alcances.

Encabezados

StockShift-Signature
string
requerido
Ejemplo:

"t=1760000000,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd"

Cuerpo

application/json
id
string
requerido

Es el mismo en cada reintento. Guárdalo y omite los eventos que ya procesaste.

type
string
requerido

El tipo del evento, siempre integrations.connection.disconnected aquí. Decide según él cuando un endpoint recibe varios eventos.

Allowed value: "integrations.connection.disconnected"
created
string<date-time>
requerido

Cuándo ocurrió el evento, como marca de tiempo ISO 8601. Los eventos pueden llegar desordenados, así que úsala para ordenarlos.

data
object
requerido

Lo que pasó, con los IDs para obtener los registros a los que se refiere.

Respuesta

2XX

Responde con cualquier 2xx en 10 segundos. Cualquier otra respuesta, o ninguna a tiempo, se reintenta con espera entre intentos durante hasta 24 horas.