RESTAPI
Sovereign Physical Distribution Platform · Cluster Node
Complete specification of HTTP/2 and gRPC REST gateway endpoints, JWT bearer tokens, role scopes, and rate limit quotas.
The Pegasus API provides programmatic access to all supply chain entities. All requests require TLS 1.3, an authorized JSON Web Token (JWT) with relevant RBAC claims, and a valid tenant header.
Architecture & Performance Highlights
Standard JSON:API Response
Every API endpoint conforms to standard response wrappers with deterministic error codes and trace IDs.
Idempotency Keys
State-changing POST/PUT requests accept Idempotency-Key headers to guarantee safe retries across spotty networks.
Adaptive Rate Limiting
Token-bucket rate limiter with per-tenant burst quotas and Redis-backed state.
Code & Configuration References
Fetch Warehouse Order Manifest
curl -X GET "https://api.pegasus-logistics.io/v1/warehouses/wh-alpha/manifests/today" \
-H "Authorization: Bearer eyJhbGciOi..." \
-H "X-Tenant-Id: sup_tashkent_fmcg_01" \
-H "Accept: application/json"Submit Batch Order Creation
curl -X POST "https://api.pegasus-logistics.io/v1/orders" \
-H "Authorization: Bearer eyJhbGciOi..." \
-H "Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d" \
-H "Content-Type: application/json" \
-d '{
"retailerId": "ret_chilanzar_77",
"deliveryDate": "2026-09-12",
"lines": [
{"sku": "SKU-BEV-001", "quantity": 50},
{"sku": "SKU-SNK-042", "quantity": 100}
]
}'Bearer Token Expiration
JWT bearer tokens have a 60-minute lifetime and should be refreshed using the /v1/auth/refresh endpoint before expiration.
Keep Exploring Pegasus Architecture & Operations
Based on the invariants, physical actors, and data flows of this module, explore these recommended companion guides and operational playbooks.