Authentication
Base URL
Section titled “Base URL”https://api.tujyaneltd.com/api/v1/delivery-apiBoth modes use the same base URL.
API keys
Section titled “API keys”Send your API key as a bearer token on every request:
Authorization: Bearer tjy_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXTujyane 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.
Headers
Section titled “Headers”| 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. |
Authentication errors
Section titled “Authentication errors”| 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. |

