# Aos Order Check

> Cloudflare Worker API for querying AOS guest orders.

## Base URL

https://aos-order-check.bbb0t.com

## Endpoints

- GET https://aos-order-check.bbb0t.com/health
- GET https://aos-order-check.bbb0t.com/api/order?url=https://www.apple.com/xc/us/vieworder/...
- GET https://aos-order-check.bbb0t.com/api/order?orderNumber=W1658420712&email=barteletscholer@gmx.com
- POST https://aos-order-check.bbb0t.com/api/order

## Input Rules

Provide either:

1. url
2. orderNumber and email

POST body example:

```json
{
  "orderNumber": "W1658420712",
  "email": "barteletscholer@gmx.com"
}
```

## Response Shape

Successful response:

```json
{
  "ok": true,
  "order": {
    "orderNumber": "W1404176537",
    "orderPlacedDate": "December 5, 2024",
    "paymentType": "APID",
    "paymentLabel": "APID",
    "isInternationalCC": true,
    "itemCount": 1,
    "hasCanceledItems": false,
    "canceledItemCount": 0,
    "statusCounts": {
      "DELIVERED": 1
    },
    "items": [
      {
        "itemId": "orderItem-0000101",
        "index": 0,
        "productName": "iPhone 16 Pro 128GB Desert Titanium",
        "itemShortName": null,
        "quantity": 1,
        "status": "DELIVERED",
        "statusDescription": "DELIVERED",
        "currentStatus": "DELIVERED",
        "isCanceled": false,
        "canceledDate": null,
        "deliveryDate": "Delivered December 12, 2024",
        "deliveryType": "HOME",
        "trackingNumbers": [],
        "trackingUrls": [],
        "shippingEditable": false
      }
    ]
  }
}
```

## Field Notes

Top-level fields:

- orderNumber
- orderPlacedDate
- paymentType
- paymentLabel
- isInternationalCC
- itemCount
- hasCanceledItems
- canceledItemCount
- statusCounts
- items

Per-item fields:

- itemId
- index
- productName
- itemShortName
- quantity
- status
- statusDescription
- currentStatus
- isCanceled
- canceledDate
- deliveryDate
- deliveryType
- trackingNumbers
- trackingUrls
- shippingEditable

## Behavior Notes

- status is the main normalized business status.
- canceledDate is populated only when item status is CANCELED.
- trackingNumbers and trackingUrls may be empty arrays.
- Orders can contain multiple items with different statuses.

## Errors

- 400 when neither url nor orderNumber/email is provided.
- 500 when Apple fetch fails or parsing fails.