Inviare un evento di prova firmato all’URL del webhook
- Nella sandbox
In parole semplici
Il corpo ha event_id, type (sempre test), occurred_at e message, firmati come un evento di stato. Non riguarda alcuna fattura. Dalla 0.16.0 qualsiasi parametro di query risponde 400.
apiKeyAuthorizationBearer <token>Inviare la chiave come token bearer: Authorization: Bearer <your-api-key>. Lo stato del servizio è l’unica chiamata che non richiede una chiave.
Ciò che l’endpoint del partner ha risposto.
application/json- response
delivered*booleanhttp_status*integer|nullduration_ms*integercurl -X POST "https://example.com/webhook/test" \ -H "Authorization: Bearer <your-api-key>"{ "delivered": true, "http_status": 0, "duration_ms": 0}Impostare l’URL del webhook, oppure cambiarne il segreto PUT
La chiave dell’operatore imposta il webhook dell’operatore, che riceve gli eventi di ogni cliente; la chiave admin di un cliente imposta quello del cliente stesso, che riceve solo i suoi eventi. La prima chiamata richiede url e crea il segreto, che viene restituito una sola volta. Il cambio restituisce il nuovo segreto una sola volta. Per 24 ore il servizio firma ogni consegna sia con il nuovo sia con il vecchio segreto, così il partner può passare all’altro senza perdere eventi. Vengono consegnati solo gli eventi scritti dopo la prima chiamata. L’URL deve essere https e ogni indirizzo a cui il suo host risolve deve essere pubblico: loopback, privato, link-local, CGNAT, multicast, riservato e indirizzi dei metadati cloud vengono rifiutati, qui e di nuovo prima di ogni consegna. I reindirizzamenti non vengono seguiti. Dalla 0.16.0 qualsiasi parametro di query risponde 400, così un client scritto male non può mai cambiare il webhook dell’operatore.
La sandbox ospitata, e come richiedere una chiave.