Delivery sandbox

Before using the real API, please start testing the integration using the sandbox API.
Notice: Each new entity created in sandbox environment, will be deleted within 24 hours

Request a token for the sandbox scope

Implement the Authentication step but pass sandbox as scope.

curl -F 'client_id=[CLIENT_ID]' \
     -F 'client_secret=[CLIENT_SECRET]' \
     -F 'grant_type=client_credentials' \
     -F 'scope=sandbox' \
     'https://api.gett.com/v1/oauth/token'

Send your request to sandbox URL

Replace delivery to delivery_sandbox on every URL that you use.
For example:
Instead of POST /v1/delivery/bundles use POST /v1/delivery_sandbox/bundles

Special requests to test status changes & webhook subscription

More details on webhook subscription you can find here Webhooks

Mock status update (In order to simulate the desired status and/or to receive event "delivery_status_changed"):

Resource:
POST v1/delivery_sandbox/deliveries/:uuid/status

Authorization:
OAuth 2.0 bearer token with sandbox scope.

Path Parameters:

Name

Type

Description

uuid

Description

Delivery id received when creating a new delivery

Query Parameters:

Name

Type

Description

business_id

string

Unique identifier representing a Business.

Body Parameters:

Name

Type

Description

status

string

One of: pending, confirmed, waiting, picked_up, driving, at_drop_off , rejected, completed, not_delivered, cancelled


Mock Optimization ended (In order to receive event "routes_optimization_ended"):

Resource:
POST v1/delivery_sandbox/bundles/:bundle_id/optimization_end

Authorization:
OAuth 2.0 bearer token with sandbox scope.

Path Parameters:

Name

Descrition

Bundle ID

the ID that was received from the create request
For example: B-xxxxxxxxxxxx

Query Parameters:

Name

Type

Description

business_id

string

Unique identifier representing a Business.


Did this page help you?