Agrega un endpoint
- Presiona Nuevo endpoint.
- Ingresa la URL. Debe ser HTTPS y accesible desde internet. Las direcciones privadas y locales se rechazan.
- Marca los eventos que quieres. La lista de eventos tiene el cuerpo de cada uno.
- Presiona Agregar endpoint.
- Copia el secreto de firma que aparece. Se muestra una sola vez. Rotar secreto genera uno nuevo.
webhook.ping de inmediato para que puedas revisar tu endpoint.
Qué recibe tu endpoint
Cada evento es unPOST con un cuerpo JSON:
2xx en menos de 10 segundos. StockShift no sigue redirecciones.
Un evento puede llegar más de una vez y fuera de orden. Los reintentos conservan el mismo id, así que guárdalo y omite los eventos que ya procesaste.
Revisa la firma
Revisa el encabezadoStockShift-Signature antes de confiar en el cuerpo. Tiene el formato t=1760000000,v1=5257a8...:
tes la hora Unix en que se envió el evento.v1es el HMAC-SHA256 de<t>.<raw body>con el secreto de firma del endpoint, en hexadecimal.
t de más de cinco minutos de antigüedad. Cada SDK tiene una función auxiliar que hace todo esto:
Reintentos
Una entrega que recibe cualquier respuesta distinta de2xx se vuelve a intentar después de 1, 5, 30, 120, 360 y 720 minutos. Si sigue fallando, o si pasan 24 horas, la entrega se marca como fallida, el endpoint se desactiva y los propietarios de la organización reciben un correo electrónico. Los eventos que ocurren mientras un endpoint está desactivado no se envían después.
La tarjeta Entregas de un endpoint muestra sus 50 entregas más recientes con su estado, código de respuesta, duración e intentos. Reintentar vuelve a enviar una entrega fallida una vez más. Las entregas se conservan durante 30 días.
Para pausar un endpoint, desmarca Activado y presiona Guardar endpoint.