# Yonne Deliveries

## Docs

- [Capacity & Weight](https://docs.yonne.app/docs/core-concepts/capacity-and-weight.md): Understand how Yonne selects vehicle classes based on shipment weight, and why ERR_NO_CAPACITY_AVAILABLE happens.
- [Error Catalog](https://docs.yonne.app/docs/core-concepts/errors.md): Every Yonne error code, what causes it, and exactly what to do next.
- [Idempotency & Retries](https://docs.yonne.app/docs/core-concepts/idempotency-and-retries.md): Use Idempotency-Key on every create-order call to prevent duplicate orders when networks fail or requests time out.
- [Rate Limiting](https://docs.yonne.app/docs/core-concepts/rate-limiting.md): Yonne enforces rate limits to protect platform stability. Use exponential backoff and avoid polling when webhooks can do the job.
- [Authentication](https://docs.yonne.app/docs/getting-started/authentication.md): Authenticate every Yonne API request using your API key in the X-API-Key header.
- [Environments](https://docs.yonne.app/docs/getting-started/environments.md): Yonne has two environments — test and live — selected by your API key prefix. The host is identical for both.
- [What is Yonne Deliveries?](https://docs.yonne.app/docs/getting-started/introduction.md): Yonne gives your application a single API to quote delivery fees, dispatch riders, and track shipments in real time across Malawi.
- [Quickstart](https://docs.yonne.app/docs/getting-started/quickstart.md): Make your first Yonne API call in under 5 minutes. You'll validate your key, get a delivery quote, and create a test order.
- [E-commerce Checkout Integration](https://docs.yonne.app/docs/integration-workflows/ecommerce-checkout.md): A step-by-step guide to integrating Yonne delivery fees and order dispatch into your e-commerce checkout flow.
- [Real-time Tracking](https://docs.yonne.app/docs/integration-workflows/real-time-tracking.md): Use Tracking IDs and webhooks to show customers live delivery status without polling.
- [Wallet Management](https://docs.yonne.app/docs/integration-workflows/wallet-management.md): Check your Yonne wallet balance, handle 402 Insufficient Funds errors gracefully, and build a top-up flow that unblocks dispatches automatically.
- [Event Catalog](https://docs.yonne.app/docs/webhooks/event-catalog.md): Every webhook event Yonne sends, with full payload examples for each.
- [Webhook Setup & Security](https://docs.yonne.app/docs/webhooks/setup-and-security.md): Configure your Yonne webhook endpoint and verify every payload with HMAC-SHA256 signature validation.

## OpenAPI Specs

- [api-1](https://docs.yonne.app/api-1.json)
- [openapi](https://docs.yonne.app/api-reference/openapi.json)