Pre-orders

# No credential needed.
curl -sS "https://api.isnap.ai/v1/area-codes?country=US"

curl -sS -X POST "https://api.isnap.ai/v1/pre-orders" \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"preferred_area_codes":["415","628"],"inbound_only":false,"metadata":{"crm_account_id":"acct_1042"}}'

# The response is saved before you read it. For a direct account it has status awaiting_payment and
# contains stripe_client_secret: keep the file out of logs, and delete it once read.
curl -sS -X POST "https://api.isnap.ai/v1/pre-orders/7f3c9a52-1d4e-4b8a-9c6f-2e5d8a1b4c7d/confirm" \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -o confirm-response.json

import { APIError, ISnapClient } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })

// Neither call honors Idempotency-Key, so the SDK must not retry them on its own.
const once = { maxRetries: 0 }

const draft = await client.preOrders.create(
  {
    preferred_area_codes: ['415', '628'],
    inbound_only: false,
    metadata: { crm_account_id: 'acct_1042' }
  },
  once
)
console.log(draft.id, draft.status)

try {
  const confirmed = await client.preOrders.confirm(draft.id, once)
  // For a direct account whose first month is due, confirmed.stripe_client_secret is the
  // secret of the first monthly payment: do not log it.
  if (confirmed.stripe_client_secret !== null) {
    console.log('Pay the first month in the iSnap dashboard within 23 hours.')
  } else {
    console.log(confirmed.status, confirmed.estimated_fulfillment)
  }
} catch (err) {
  if (err instanceof APIError && err.code === 'pre_order_not_draft') {
    // Already confirmed or canceled: read it with preOrders.get.
    console.error('This pre-order is not a draft.')
  } else {
    throw err
  }
}

import os

import requests

API = "https://api.isnap.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}"}

# Neither call honors Idempotency-Key: do not retry them blindly.
created = requests.post(
    f"{API}/v1/pre-orders",
    headers=HEADERS,
    json={
        "preferred_area_codes": ["415", "628"],
        "inbound_only": False,
        "metadata": {"crm_account_id": "acct_1042"},
    },
    timeout=30,
)
created.raise_for_status()
draft = created.json()["data"]
print(draft["id"], draft["status"])

confirmed = requests.post(f"{API}/v1/pre-orders/{draft['id']}/confirm", headers=HEADERS, timeout=30)
payload = confirmed.json()

if confirmed.status_code == 200:
    pre_order = payload["data"]
    # For a direct account whose first month is due, pre_order["stripe_client_secret"] is the
    # secret of the first monthly payment: do not log it.
    if pre_order["stripe_client_secret"] is not None:
        print("Pay the first month in the iSnap dashboard within 23 hours.")
    else:
        print(pre_order["status"], pre_order["estimated_fulfillment"])
elif payload["error"]["code"] == "pre_order_not_draft":
    # Already confirmed or canceled: read it with GET /v1/pre-orders/{id}.
    print("This pre-order is not a draft.")
else:
    confirmed.raise_for_status()

curl -sS "https://api.isnap.ai/v1/pre-orders?status=provisioning&limit=100" \
  -H "Authorization: Bearer $ISNAP_API_KEY"

import { ISnapClient } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })

// preOrders.list returns one page: pass next_cursor back as cursor, with the same status.
let cursor: string | undefined
do {
  const page = await client.preOrders.list({ status: 'provisioning', limit: 100, cursor })
  for (const preOrder of page.items) {
    console.log(preOrder.id, preOrder.device_status, preOrder.estimated_fulfillment)
  }
  cursor = page.has_more && page.next_cursor ? page.next_cursor : undefined
} while (cursor)

import os

import requests

params = {"status": "provisioning", "limit": 100}

while True:
    response = requests.get(
        "https://api.isnap.ai/v1/pre-orders",
        headers={"Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}"},
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    page = response.json()["data"]
    for pre_order in page["items"]:
        print(pre_order["id"], pre_order["device_status"], pre_order["estimated_fulfillment"])
    if not page["has_more"] or page["next_cursor"] is None:
        break
    # Keep the same status on every page of the walk.
    params["cursor"] = page["next_cursor"]