Skip to content

Authentication

https://api.tujyaneltd.com/api/v1/delivery-api

Both modes use the same base URL.

Send your API key as a bearer token on every request:

Authorization: Bearer tjy_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Tujyane issues the keys, and revokes a key when you ask. The key’s prefix sets the mode:

Prefix Mode What happens
tjy_test_ TEST A simulated partner runs each Shipment in about a minute. Nothing is billed, and no real partner sees it.
tjy_live_ LIVE Real Delivery Partners carry the Shipment, and you are billed for it.

A key sees only the Shipments of its own mode. Reading a Shipment of the other mode answers 404.

Keep keys on your server. Never put a key in a mobile app, a web page, or source control. If a key leaks, ask Tujyane to revoke it and issue a new one.

Header When
Authorization: Bearer <key> Every request.
Content-Type: application/json Every request with a body. Without it, Tujyane ignores the body, and validation fails.
Idempotency-Key: <8 to 255 characters> Every POST that creates or changes a Shipment. See Idempotency.
Accept-Language: fr or rw Optional. Translates error messages into French or Kinyarwanda.
Status When
401 The header is missing, or the key is unknown or revoked. The message is Send a valid Delivery API key as Authorization: Bearer <key>.
403 CLIENT_DISABLED Tujyane disabled your account.