Webhook Overview
AfterShip Shipping can send a webhook to notify your system when a particular event has happened. Learn to set up webhooks.
How to setup the Webhook
You can enable the webhook from the webhooks settings, and click Add Webhooks URL
button.
Securing Webhook
We currently support either HTTP or HTTPS URLs. So you can have security by using an SSL-enabled URL. But keep in mind that your endpoint is going to be wide-open on the Internet, and you might not want others to be able to submit random data to your systems. At this time, aside from trying to keep the URL private, our best advice is to simply include a secret key in the URL that you provide and check the secret GET parameter in your scripts.
Retry Webhook
AfterShip Shipping sends event-driven data to webhook URL via POST method. In case of an unsuccessful event (HTTP response code NOT between 200 and 299), AfterShip Shipping will make 14 attempts to deliver your webhook with exponential backoff.
The current attempt webhook delay is calculated by this formula: 2^(number of retry) x 30s
# of attempt | # of retry | Delay (sec) before send out | Acc. Delay (sec) |
---|---|---|---|
1 | 0 | 0 | 0 |
2 | 1 | 30 | 30 |
3 | 2 | 60 | 90 |
4 | 3 | 120 | 210 |
5 | 4 | 240 | 450 |
6 | 5 | 480 | 930 |
7 | 6 | 960 | 1890 |
8 | 7 | 1920 | 3810 |
9 | 8 | 3840 | 7650 |
10 | 9 | 7680 | 15330 |
11 | 10 | 15360 | 30690 |
12 | 11 | 30720 | 61410 |
13 | 12 | 61440 | 122850 |
14 | 13 | 122880 | 245730 |
For example, If the attempt fails, AfterShip Shipping will retry the 2nd attempt 30s later.
If the 7th attempts fail, AfterShip Shipping retry the 8th attempt 960s later
If the 14th attempts fail, AfterShip Shipping will not send out that webhook.