The delivery platform you run in your own cloud.

# Locally (make up): ORDERS=http://localhost:8000

# 1. Ask for a price and an ETA. A quote is valid for 2 minutes.
curl "$ORDERS/v1/quotes" \
  -H "Authorization: Bearer $TASUKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "store_id": "str_01JA2Q…",
    "dropoff": {
      "lat": 35.6618, "lng": 139.6983, "ward": "shibuya",
      "address": "1-2-3 Jinnan, Shibuya-ku",
      "customer_name": "Sato Hana", "customer_phone": "090-1234-5678"
    }
  }'
# 201 {"quote_id": "quo_01JA2R…", "fee_yen": 742, "eta_seconds": 1920, "expires_at": "…"}

# 2. Turn the quote into an order. Retrying with the same key never creates a second one.
curl "$ORDERS/v1/orders" \
  -H "Authorization: Bearer $TASUKI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: checkout-8812" \
  -d '{"quote_id": "quo_01JA2R…"}'
# 201 {"order_id": "ord_01JA2S…", "status": "confirmed", "tracking_url": "…/track/eyJhbGci…"}

// Send your customer the tracking_url as it is (a hosted page in English and Japanese),
// or draw the delivery inside your own app. Locally: TRACKING = "http://localhost:8083".
const stream = new EventSource(`${TRACKING}/v1/track/${token}/stream`);

stream.addEventListener("status", (e) => {
  const { status, eta } = JSON.parse(e.data); // confirmed → assigned → picked_up → delivered
  renderStatus(status, eta);
});

stream.addEventListener("position", (e) => {
  const { lat, lng } = JSON.parse(e.data); // the assigned driver, every few seconds
  moveDriverMarker(lat, lng);
});

// delivered, cancelled, failed or expired: the server closes the stream
stream.addEventListener("end", () => stream.close());

# What a driver app sends. Locally: FLEET=http://localhost:8081, DISPATCH=http://localhost:8082

# Every few seconds while moving: a batch of 1 to 50 GPS points.
curl "$FLEET/v1/locations" \
  -H "Authorization: Bearer $DRIVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"points": [{
        "lat": 35.6581, "lng": 139.7017, "accuracy_m": 8,
        "speed_mps": 4.2, "heading_deg": 90,
        "device_time": "2026-10-16T03:12:08Z",
        "status": "to_dropoff", "order_id": "ord_01JA2S…"
      }]}'
# 202 {"accepted": 1, "dropped": 0}  (503 + Retry-After when the platform sheds load)

# Offers arrive on a stream. The driver has 30 seconds to answer.
curl -N "$DISPATCH/v1/couriers/me/offers/stream" -H "Authorization: Bearer $DRIVER_TOKEN"
curl -X POST "$DISPATCH/v1/offers/off_01JA2T…/accept" -H "Authorization: Bearer $DRIVER_TOKEN"

# Proof of delivery: the driver must be within 500 m of the drop-off.
curl -X POST "$ORDERS/v1/courier/orders/ord_01JA2S…/deliver" \
  -H "Authorization: Bearer $DRIVER_TOKEN" -H "Content-Type: application/json" \
  -d '{"lat": 35.6619, "lng": 139.6981}'

# Today: read an order with its full status history.
curl "$ORDERS/v1/orders/ord_01JA2S…" -H "Authorization: Bearer $TASUKI_API_KEY"

# Next on the roadmap: signed webhooks to your endpoint, retried until it answers 2xx,
# signed with HMAC-SHA256 over a timestamp and the body, with a 5-minute replay window.
# They carry the events the platform already publishes inside, for example:
{
  "schema": "order.event.v1",
  "event_id": "evt_01JA2V…",
  "type": "OrderPickedUp",
  "order_id": "ord_01JA2S…",
  "merchant_id": "mer_01JA2P…",
  "occurred_at": "2026-10-16T03:14:41Z"
}