istatus Open API

# istatus-pull.sh — ต้องมี curl + jq
# เก็บ key ใน env เท่านั้น: export ISTATUS_API_KEY="ist_..." (ห้ามพิมพ์ key ลงไฟล์สคริปต์/git)
BASE="https://istatus.net"

# ดึงรายการแบบไล่ cursor จนหมด + รอเองเมื่อโดนฟิวส์ 429 (อ่าน Retry-After)
pull_all() {  # ใช้: pull_all /api/v1/orders "from=2026-08-01"
  local path="$1" query="$2" cursor="" res http wait
  while :; do
    res=$(curl -s -w '\n%{http_code}' -D /tmp/istatus-h -G "$BASE$path" \
      -H "Authorization: Bearer $ISTATUS_API_KEY" \
      --data-urlencode "limit=100" \
      ${query:+--data-urlencode "$query"} \
      ${cursor:+--data-urlencode "cursor=$cursor"})
    http=${res##*$'\n'}; res=${res%$'\n'*}
    if [ "$http" = "429" ]; then           # ฟิวส์ความถี่ — รอตาม Retry-After แล้วยิงใหม่
      wait=$(grep -i '^retry-after' /tmp/istatus-h | tr -dc '0-9'); sleep "${wait:-1}"; continue
    fi
    if [ "$http" != "200" ]; then echo "$res" | jq -r '"ERROR " + .code + ": " + .message' >&2; return 1; fi
    echo "$res" | jq -c '.rows[]'          # หนึ่งบรรทัดต่อหนึ่งรายการ — เอาไป pipe ต่อได้
    cursor=$(echo "$res" | jq -r '.nextCursor // empty')
    [ -z "$cursor" ] && break              # nextCursor = null → หมดแล้ว
  done
}

<?php
// istatus-client.php — PHP 8.0+ (ext-curl)
// เก็บ key ใน env เท่านั้น (.env / ตั้งใน server config) — ห้าม hardcode ในโค้ด
const ISTATUS_BASE = 'https://istatus.net';

function istatus_get(string $path, array $params = []): array {
    $key = getenv('ISTATUS_API_KEY') ?: throw new RuntimeException('ตั้ง env ISTATUS_API_KEY ก่อน');
    $params = array_filter($params, fn($v) => $v !== null && $v !== '');
    $url = ISTATUS_BASE . $path . ($params ? '?' . http_build_query($params) : '');
    for ($attempt = 0; $attempt < 5; $attempt++) {
        $retryAfter = 1;
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key],
            // อ่านค่า Retry-After จาก header ไว้ใช้ตอนโดนฟิวส์ 429
            CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$retryAfter) {
                if (stripos($line, 'Retry-After:') === 0) $retryAfter = max(1, (int) trim(substr($line, 12)));
                return strlen($line);
            },
        ]);
        $raw    = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        curl_close($ch);
        if ($status === 429) { sleep($retryAfter); continue; }   // ฟิวส์ความถี่ — รอแล้วยิงใหม่
        $body = json_decode((string) $raw, true) ?? [];
        if ($status >= 400) {                                    // ตัดสินใจจาก code เครื่องอ่านได้
            throw new RuntimeException(($body['code'] ?? "HTTP $status") . ': ' . ($body['message'] ?? 'error'));
        }
        return $body;
    }
    throw new RuntimeException('RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก');
}

// ไล่ทุกหน้าด้วย cursor จนหมด (ใช้กับทุก endpoint ที่เป็นรายการ)
function istatus_get_all(string $path, array $params = []): array {
    $rows = []; $cursor = null;
    do {
        $page   = istatus_get($path, array_merge($params, ['limit' => 100, 'cursor' => $cursor]));
        $rows   = array_merge($rows, $page['rows']);
        $cursor = $page['nextCursor'] ?? null;
    } while ($cursor);
    return $rows;
}

// istatus-client.mjs — Node.js 18+ (ใช้ fetch ในตัว ไม่ต้องลงแพ็กเกจ)
// เก็บ key ใน env เท่านั้น: export ISTATUS_API_KEY=ist_... (ห้าม hardcode ในโค้ด/คอมมิตลง git)
const BASE = 'https://istatus.net';
const KEY = process.env.ISTATUS_API_KEY;
if (!KEY) throw new Error('ตั้ง env ISTATUS_API_KEY ก่อน');

export async function istatusGet(path, params = {}) {
  const url = new URL(path, BASE);
  for (const [k, v] of Object.entries(params)) if (v != null && v !== '') url.searchParams.set(k, v);
  for (let attempt = 0; attempt < 5; attempt++) {
    const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
    if (res.status === 429) {                       // ฟิวส์ความถี่ — รอตาม Retry-After แล้วยิงใหม่
      const wait = Number(res.headers.get('retry-after')) || 1;
      await new Promise(r => setTimeout(r, wait * 1000));
      continue;
    }
    const body = await res.json();
    if (!res.ok) throw new Error(`${body.code}: ${body.message}`);  // ตัดสินใจจาก code เครื่องอ่านได้
    return body;
  }
  throw new Error('RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก');
}

// ไล่ทุกหน้าด้วย cursor จนหมด (ใช้กับทุก endpoint ที่เป็นรายการ)
export async function istatusGetAll(path, params = {}) {
  const rows = [];
  let cursor = null;
  do {
    const page = await istatusGet(path, { ...params, limit: 100, cursor });
    rows.push(...page.rows);
    cursor = page.nextCursor;
  } while (cursor);
  return rows;
}

# istatus_client.py — Python 3.9+ (pip install requests)
# เก็บ key ใน env เท่านั้น: export ISTATUS_API_KEY=ist_... (ห้าม hardcode ในโค้ด/คอมมิตลง git)
import os, time, requests

BASE = "https://istatus.net"
KEY = os.environ["ISTATUS_API_KEY"]  # ไม่มี env = ให้พังตั้งแต่เริ่ม ดีกว่ายิงด้วย key ว่าง


def istatus_get(path: str, params: dict | None = None) -> dict:
    for _attempt in range(5):
        res = requests.get(
            BASE + path,
            params={k: v for k, v in (params or {}).items() if v is not None},
            headers={"Authorization": f"Bearer {KEY}"},
            timeout=30,
        )
        if res.status_code == 429:  # ฟิวส์ความถี่ — รอตาม Retry-After แล้วยิงใหม่
            time.sleep(int(res.headers.get("Retry-After", "1")))
            continue
        body = res.json()
        if not res.ok:  # ตัดสินใจจาก code เครื่องอ่านได้
            raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
        return body
    raise RuntimeError("RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก")


def istatus_get_all(path: str, params: dict | None = None) -> list:
    """ไล่ทุกหน้าด้วย cursor จนหมด (ใช้กับทุก endpoint ที่เป็นรายการ)"""
    rows, cursor = [], None
    while True:
        page = istatus_get(path, {**(params or {}), "limit": 100, "cursor": cursor})
        rows += page["rows"]
        cursor = page.get("nextCursor")
        if not cursor:
            return rows

// IstatusClient.cs — .NET 6+
// เก็บ key ใน env เท่านั้น (ห้าม hardcode ในโค้ด/คอมมิตลง git)
using System.Net;
using System.Net.Http.Headers;
using System.Text.Json;

public static class IstatusClient
{
    static readonly HttpClient Http = new() { BaseAddress = new Uri("https://istatus.net") };
    static readonly string Key = Environment.GetEnvironmentVariable("ISTATUS_API_KEY")
        ?? throw new InvalidOperationException("ตั้ง env ISTATUS_API_KEY ก่อน");

    public static async Task<JsonElement> GetAsync(string path, Dictionary<string, string?>? query = null)
    {
        var qs = query == null ? "" : string.Join("&", query
            .Where(kv => !string.IsNullOrEmpty(kv.Value))
            .Select(kv => $"{Uri.EscapeDataString(kv.Key)}={Uri.EscapeDataString(kv.Value!)}"));
        var url = path + (qs.Length > 0 ? "?" + qs : "");
        for (var attempt = 0; attempt < 5; attempt++)
        {
            using var req = new HttpRequestMessage(HttpMethod.Get, url);
            req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Key);
            using var res = await Http.SendAsync(req);
            if (res.StatusCode == HttpStatusCode.TooManyRequests)
            {   // ฟิวส์ความถี่ — รอตาม Retry-After แล้วยิงใหม่
                await Task.Delay(res.Headers.RetryAfter?.Delta ?? TimeSpan.FromSeconds(1));
                continue;
            }
            var body = JsonSerializer.Deserialize<JsonElement>(await res.Content.ReadAsStringAsync());
            if (!res.IsSuccessStatusCode)  // ตัดสินใจจาก code เครื่องอ่านได้
                throw new Exception($"{body.GetProperty("code").GetString()}: {body.GetProperty("message").GetString()}");
            return body;
        }
        throw new Exception("RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก");
    }

    // ไล่ทุกหน้าด้วย cursor จนหมด (ใช้กับทุก endpoint ที่เป็นรายการ)
    public static async Task<List<JsonElement>> GetAllAsync(string path, Dictionary<string, string?>? query = null)
    {
        var rows = new List<JsonElement>();
        string? cursor = null;
        do
        {
            var q = new Dictionary<string, string?>(query ?? new()) { ["limit"] = "100", ["cursor"] = cursor };
            var page = await GetAsync(path, q);
            rows.AddRange(page.GetProperty("rows").EnumerateArray().Select(e => e.Clone()));
            var next = page.GetProperty("nextCursor");
            cursor = next.ValueKind == JsonValueKind.String ? next.GetString() : null;
        } while (cursor != null);
        return rows;
    }
}

# ── ส่งข้อมูลเข้า (POST/PUT) — ต่อจากโครงหลักด้านบน ──
# สำคัญ: ต้องดู "รหัสสถานะ" ด้วย ไม่ใช่ดูแต่ body — 201 บันทึกแล้ว · 202 เข้าห้องรอ (สำเร็จ!) · 200 เลขนี้เคยส่งแล้ว
istatus_send() {  # ใช้: istatus_send POST /api/v1/orders '{"externalOrderNo":"PO-1","items":[{"sku":"A-001","qty":2}]}'
  local method="$1" path="$2" data="$3" res http wait
  while :; do
    res=$(curl -s -w '\n%{http_code}' -D /tmp/istatus-h -X "$method" "$BASE$path" \
      -H "Authorization: Bearer $ISTATUS_API_KEY" -H 'Content-Type: application/json' -d "$data")
    http=${res##*$'\n'}; res=${res%$'\n'*}
    if [ "$http" = "429" ]; then          # ฟิวส์ความถี่ (เขียน ~2/วิ) — รอตาม Retry-After แล้วยิงใหม่
      wait=$(grep -i '^retry-after' /tmp/istatus-h | tr -dc '0-9'); sleep "${wait:-1}"; continue
    fi
    break
  done
  case "$http" in
    201) echo "created  $res";;           # บันทึกเป็นบิลจริงแล้ว
    202) echo "held     $res";;           # โควตาแพ็กเต็ม → เข้าห้องรอ ระบบจะบันทึกให้เอง — ห้ามยิงซ้ำ
    200) echo "already  $res";;           # เลขนี้เคยส่งแล้ว (idempotent) = ไม่มีบิลซ้ำ
    *)   echo "ERROR $http $(echo "$res" | jq -r '.code + ": " + .message')" >&2; return 1;;
  esac
}

// ── ส่งข้อมูลเข้า (POST/PUT) — ต่อจากโครงหลักด้านบน ──
// คืน status มาด้วยเสมอ เพราะ 201 (บันทึกแล้ว) / 202 (เข้าห้องรอ) / 200 (เคยส่งแล้ว) คนละความหมาย แต่ "สำเร็จ" ทั้งหมด
function istatus_send(string $method, string $path, array $payload): array {
    $key = getenv('ISTATUS_API_KEY') ?: throw new RuntimeException('ตั้ง env ISTATUS_API_KEY ก่อน');
    for ($attempt = 0; $attempt < 5; $attempt++) {
        $retryAfter = 1;
        $ch = curl_init(ISTATUS_BASE . $path);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT        => 30,
            CURLOPT_CUSTOMREQUEST  => $method,
            CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
            CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $key, 'Content-Type: application/json'],
            CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$retryAfter) {
                if (stripos($line, 'Retry-After:') === 0) $retryAfter = max(1, (int) trim(substr($line, 12)));
                return strlen($line);
            },
        ]);
        $raw    = curl_exec($ch);
        $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        curl_close($ch);
        if ($status === 429) { sleep($retryAfter); continue; }
        $body = json_decode((string) $raw, true) ?? [];
        if ($status >= 400) {
            throw new RuntimeException(($body['code'] ?? "HTTP $status") . ': ' . ($body['message'] ?? 'error'));
        }
        return ['status' => $status, 'body' => $body];
    }
    throw new RuntimeException('RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก');
}

// ── ส่งข้อมูลเข้า (POST/PUT) — ต่อจากโครงหลักด้านบน ──
// คืน { status, body } เสมอ: 201 บันทึกแล้ว · 202 เข้าห้องรอ (สำเร็จ ห้ามยิงซ้ำ) · 200 เลขนี้เคยส่งแล้ว
export async function istatusSend(method, path, payload) {
  for (let attempt = 0; attempt < 5; attempt++) {
    const res = await fetch(new URL(path, BASE), {
      method,
      headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
      body: JSON.stringify(payload),
    });
    if (res.status === 429) {                       // ฟิวส์ความถี่ (เขียน ~2/วิ)
      const wait = Number(res.headers.get('retry-after')) || 1;
      await new Promise(r => setTimeout(r, wait * 1000));
      continue;
    }
    const body = await res.json();
    if (!res.ok) throw new Error(`${body.code}: ${body.message}`);
    return { status: res.status, body };
  }
  throw new Error('RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก');
}

# ── ส่งข้อมูลเข้า (POST/PUT) — ต่อจากโครงหลักด้านบน ──
# คืน (status, body): 201 บันทึกแล้ว · 202 เข้าห้องรอ (สำเร็จ ห้ามยิงซ้ำ) · 200 เลขนี้เคยส่งแล้ว
def istatus_send(method: str, path: str, payload: dict) -> tuple:
    for _attempt in range(5):
        res = requests.request(
            method, BASE + path, json=payload,
            headers={"Authorization": f"Bearer {KEY}"}, timeout=30,
        )
        if res.status_code == 429:  # ฟิวส์ความถี่ (เขียน ~2/วิ)
            time.sleep(int(res.headers.get("Retry-After", "1")))
            continue
        body = res.json()
        if not res.ok:
            raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
        return res.status_code, body
    raise RuntimeError("RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก")

// ── ส่งข้อมูลเข้า (POST/PUT) — เพิ่มเมธอดนี้ในคลาส IstatusClient เดิม ──
// คืน (Status, Body): 201 บันทึกแล้ว · 202 เข้าห้องรอ (สำเร็จ ห้ามยิงซ้ำ) · 200 เลขนี้เคยส่งแล้ว
public static async Task<(int Status, JsonElement Body)> SendAsync(HttpMethod method, string path, object payload)
{
    for (var attempt = 0; attempt < 5; attempt++)
    {
        using var req = new HttpRequestMessage(method, path)
        {
            Content = new StringContent(JsonSerializer.Serialize(payload),
                                        System.Text.Encoding.UTF8, "application/json"),
        };
        req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Key);
        using var res = await Http.SendAsync(req);
        if (res.StatusCode == HttpStatusCode.TooManyRequests)
        {   // ฟิวส์ความถี่ (เขียน ~2/วิ) — รอตาม Retry-After แล้วยิงใหม่
            await Task.Delay(res.Headers.RetryAfter?.Delta ?? TimeSpan.FromSeconds(1));
            continue;
        }
        var body = JsonSerializer.Deserialize<JsonElement>(await res.Content.ReadAsStringAsync());
        if (!res.IsSuccessStatusCode)
            throw new Exception($"{body.GetProperty("code").GetString()}: {body.GetProperty("message").GetString()}");
        return ((int)res.StatusCode, body);
    }
    throw new Exception("RATE_LIMITED: ยิงซ้ำ 5 ครั้งแล้วยังติดฟิวส์ — ลดความถี่การเรียก");
}

curl -s https://istatus.net/api/v1/ping \
  -H "Authorization: Bearer $ISTATUS_API_KEY"

// ใช้ istatus_get() จากโครงหลักด้านบน
print_r(istatus_get('/api/v1/ping'));

// ใช้ istatusGet() จากโครงหลักด้านบน
console.log(await istatusGet('/api/v1/ping'));

# ใช้ istatus_get() จากโครงหลักด้านบน
print(istatus_get("/api/v1/ping"))

// ใช้ IstatusClient จากโครงหลักด้านบน
var ping = await IstatusClient.GetAsync("/api/v1/ping");
Console.WriteLine(ping.GetProperty("shopName").GetString());

# หน้าเดียว
curl -s -G https://istatus.net/api/v1/orders \
  -H "Authorization: Bearer $ISTATUS_API_KEY" \
  --data-urlencode "from=2026-08-01" --data-urlencode "to=2026-08-31" \
  --data-urlencode "status=paid" --data-urlencode "limit=100"

# ทุกหน้า (ไล่ cursor + รอเมื่อโดน 429) — ใช้ pull_all จากโครงหลักด้านบน
pull_all /api/v1/orders "from=2026-08-01" | jq -r '[.orderNo, .channel, (.total/100)] | @tsv'

// ออเดอร์ที่ขายแล้วของเดือนสิงหา — ทุกหน้า (istatus_get_all ไล่ cursor + รอ 429 ให้เอง)
$orders = istatus_get_all('/api/v1/orders', [
    'from' => '2026-08-01', 'to' => '2026-08-31', 'status' => 'paid',
]);
foreach ($orders as $o) {
    printf("%s  %s  %.2f บาท\n", $o['orderNo'], $o['channel'], $o['total'] / 100);
    foreach ($o['items'] as $it) {
        printf("   - %s x%d @ %.2f\n", $it['sku'], $it['qty'], $it['price'] / 100);
    }
}

// ออเดอร์ที่ขายแล้วของเดือนสิงหา — ทุกหน้า (istatusGetAll ไล่ cursor + รอ 429 ให้เอง)
const orders = await istatusGetAll('/api/v1/orders', {
  from: '2026-08-01', to: '2026-08-31', status: 'paid',
});
for (const o of orders) {
  console.log(o.orderNo, o.channel, (o.total / 100).toFixed(2), 'บาท');
  for (const it of o.items) console.log('  -', it.sku, 'x' + it.qty, '@', (it.price / 100).toFixed(2));
}

# ออเดอร์ที่ขายแล้วของเดือนสิงหา — ทุกหน้า (istatus_get_all ไล่ cursor + รอ 429 ให้เอง)
orders = istatus_get_all("/api/v1/orders", {
    "from": "2026-08-01", "to": "2026-08-31", "status": "paid",
})
for o in orders:
    print(o["orderNo"], o["channel"], o["total"] / 100, "บาท")
    for it in o["items"]:
        print("  -", it["sku"], "x", it["qty"], "@", it["price"] / 100)

// ออเดอร์ที่ขายแล้วของเดือนสิงหา — ทุกหน้า (GetAllAsync ไล่ cursor + รอ 429 ให้เอง)
var orders = await IstatusClient.GetAllAsync("/api/v1/orders", new()
{
    ["from"] = "2026-08-01", ["to"] = "2026-08-31", ["status"] = "paid",
});
foreach (var o in orders)
{
    Console.WriteLine($"{o.GetProperty("orderNo").GetString()}  {o.GetProperty("channel").GetString()}  {o.GetProperty("total").GetInt64() / 100.0:F2} บาท");
}

# ค้นหาสินค้า
curl -s -G https://istatus.net/api/v1/products \
  -H "Authorization: Bearer $ISTATUS_API_KEY" \
  --data-urlencode "q=A-0" --data-urlencode "limit=100"

# sync สินค้าทั้งร้าน (ทุกหน้า)
pull_all /api/v1/products "" | jq -r '[.sku, .name, (.price/100), .stock, .active] | @tsv'

// sync สินค้าทั้งร้านเข้าฐานคุณ — ทุกหน้า
$products = istatus_get_all('/api/v1/products');
foreach ($products as $p) {
    if (!$p['active']) { /* ปิดใช้งานฝั่งคุณด้วย */ continue; }
    printf("%s  %s  %.2f บาท  คงเหลือ %d\n", $p['sku'], $p['name'], $p['price'] / 100, $p['stock']);
}

// sync สินค้าทั้งร้านเข้าฐานคุณ — ทุกหน้า
const products = await istatusGetAll('/api/v1/products');
for (const p of products) {
  if (!p.active) continue;               // ตัวที่ถูกปิด — ปิดใช้งานฝั่งคุณด้วย
  console.log(p.sku, p.name, (p.price / 100).toFixed(2), 'บาท คงเหลือ', p.stock);
}

# sync สินค้าทั้งร้านเข้าฐานคุณ — ทุกหน้า
products = istatus_get_all("/api/v1/products")
for p in products:
    if not p["active"]:
        continue  # ตัวที่ถูกปิด — ปิดใช้งานฝั่งคุณด้วย
    print(p["sku"], p["name"], p["price"] / 100, "บาท คงเหลือ", p["stock"])

// sync สินค้าทั้งร้านเข้าฐานคุณ — ทุกหน้า
var products = await IstatusClient.GetAllAsync("/api/v1/products");
foreach (var p in products.Where(p => p.GetProperty("active").GetBoolean()))
{
    Console.WriteLine($"{p.GetProperty("sku").GetString()}  {p.GetProperty("name").GetString()}  {p.GetProperty("price").GetInt64() / 100.0:F2} บาท");
}

# เช็ค SKU เดียว
curl -s -G https://istatus.net/api/v1/stock \
  -H "Authorization: Bearer $ISTATUS_API_KEY" \
  --data-urlencode "sku=A-001"

# สต๊อกทั้งร้าน (ทุกหน้า)
pull_all /api/v1/stock "" | jq -r '[.sku, .stock] | @tsv'

// เช็ค SKU เดียว
$page = istatus_get('/api/v1/stock', ['sku' => 'A-001']);
echo ($page['rows'][0]['stock'] ?? 'ไม่พบ SKU นี้') . "\n";

// สต๊อกทั้งร้าน — ทุกหน้า
$stock = istatus_get_all('/api/v1/stock');

// เช็ค SKU เดียว
const page = await istatusGet('/api/v1/stock', { sku: 'A-001' });
console.log(page.rows[0]?.stock ?? 'ไม่พบ SKU นี้');

// สต๊อกทั้งร้าน — ทุกหน้า
const stock = await istatusGetAll('/api/v1/stock');

# เช็ค SKU เดียว
page = istatus_get("/api/v1/stock", {"sku": "A-001"})
print(page["rows"][0]["stock"] if page["rows"] else "ไม่พบ SKU นี้")

# สต๊อกทั้งร้าน — ทุกหน้า
stock = istatus_get_all("/api/v1/stock")

// เช็ค SKU เดียว
var page = await IstatusClient.GetAsync("/api/v1/stock", new() { ["sku"] = "A-001" });
var rows = page.GetProperty("rows");
Console.WriteLine(rows.GetArrayLength() > 0 ? rows[0].GetProperty("stock").GetInt32().ToString() : "ไม่พบ SKU นี้");

// สต๊อกทั้งร้าน — ทุกหน้า
var stock = await IstatusClient.GetAllAsync("/api/v1/stock");

# ค้นหาลูกค้า
curl -s -G https://istatus.net/api/v1/customers \
  -H "Authorization: Bearer $ISTATUS_API_KEY" \
  --data-urlencode "q=สมชาย"

# ลูกค้าทั้งร้าน (ทุกหน้า)
pull_all /api/v1/customers "" | jq -r '[.name, .phone] | @tsv'

// ค้นหาลูกค้าจากเบอร์โทร
$page = istatus_get('/api/v1/customers', ['q' => '0812345678']);

// ลูกค้าทั้งร้าน — ทุกหน้า
$customers = istatus_get_all('/api/v1/customers');

// ค้นหาลูกค้าจากเบอร์โทร
const page = await istatusGet('/api/v1/customers', { q: '0812345678' });

// ลูกค้าทั้งร้าน — ทุกหน้า
const customers = await istatusGetAll('/api/v1/customers');

# ค้นหาลูกค้าจากเบอร์โทร
page = istatus_get("/api/v1/customers", {"q": "0812345678"})

# ลูกค้าทั้งร้าน — ทุกหน้า
customers = istatus_get_all("/api/v1/customers")

// ค้นหาลูกค้าจากเบอร์โทร
var page = await IstatusClient.GetAsync("/api/v1/customers", new() { ["q"] = "0812345678" });

// ลูกค้าทั้งร้าน — ทุกหน้า
var customers = await IstatusClient.GetAllAsync("/api/v1/customers");

# ส่งออเดอร์เข้า istatus — "PO-2026-0042" คือเลขออเดอร์ในระบบของคุณ (ใช้กันบันทึกซ้ำ)
istatus_send POST /api/v1/orders '{
  "externalOrderNo": "PO-2026-0042",
  "items": [{"sku": "A-001", "qty": 2}, {"sku": "B-020", "qty": 1}],
  "note": "ส่งด่วน"
}'
# ผลลัพธ์: created / held / already  — ทั้งสามแบบ = ส่งสำเร็จ ไม่ต้องยิงซ้ำ

# เน็ตหลุดไม่รู้ผล? ยิงซ้ำ payload เดิมได้เลย — เลขเดิม = บิลเดิม ไม่มีทางเกิดบิลซ้ำ

$r = istatus_send('POST', '/api/v1/orders', [
    'externalOrderNo' => 'PO-2026-0042',                       // เลขในระบบคุณ = กุญแจกันบันทึกซ้ำ
    'items'           => [['sku' => 'A-001', 'qty' => 2]],     // ราคาใช้ของแคตตาล็อกในร้าน
    'note'            => 'ส่งด่วน',
]);
if ($r['status'] === 202) {
    // โควตาออเดอร์ของแพ็กเดือนนี้เต็ม → เข้าห้องรอแล้ว ระบบบันทึกให้เองเมื่ออัปแพ็ก/ขึ้นเดือนใหม่
    error_log('เข้าห้องรอ — คิวรวม ' . $r['body']['heldCount'] . ' ใบ (ห้ามยิงซ้ำ)');
} else {
    echo $r['body']['orderNo'];        // API-PO-2026-0042 (201 = สร้างใหม่ · 200 = เคยส่งแล้ว)
}

const r = await istatusSend('POST', '/api/v1/orders', {
  externalOrderNo: 'PO-2026-0042',                 // เลขในระบบคุณ = กุญแจกันบันทึกซ้ำ
  items: [{ sku: 'A-001', qty: 2 }],               // ราคาใช้ของแคตตาล็อกในร้าน
  note: 'ส่งด่วน',
});
if (r.status === 202) {
  // โควตาแพ็กเดือนนี้เต็ม → เข้าห้องรอ ระบบบันทึกให้เองเมื่ออัปแพ็ก/ขึ้นเดือนใหม่ (ห้ามยิงซ้ำ)
  console.log('เข้าห้องรอ — คิวรวม', r.body.heldCount, 'ใบ');
} else {
  console.log('บันทึกแล้ว', r.body.orderNo);       // API-PO-2026-0042
}

status, body = istatus_send("POST", "/api/v1/orders", {
    "externalOrderNo": "PO-2026-0042",             # เลขในระบบคุณ = กุญแจกันบันทึกซ้ำ
    "items": [{"sku": "A-001", "qty": 2}],         # ราคาใช้ของแคตตาล็อกในร้าน
    "note": "ส่งด่วน",
})
if status == 202:
    # โควตาแพ็กเดือนนี้เต็ม → เข้าห้องรอ ระบบบันทึกให้เองเมื่ออัปแพ็ก/ขึ้นเดือนใหม่ (ห้ามยิงซ้ำ)
    print("เข้าห้องรอ — คิวรวม", body["heldCount"], "ใบ")
else:
    print("บันทึกแล้ว", body["orderNo"])           # API-PO-2026-0042

var (status, body) = await IstatusClient.SendAsync(HttpMethod.Post, "/api/v1/orders", new
{
    externalOrderNo = "PO-2026-0042",              // เลขในระบบคุณ = กุญแจกันบันทึกซ้ำ
    items = new[] { new { sku = "A-001", qty = 2 } },
    note = "ส่งด่วน",
});
if (status == 202)
    // โควตาแพ็กเดือนนี้เต็ม → เข้าห้องรอ ระบบบันทึกให้เองเมื่ออัปแพ็ก/ขึ้นเดือนใหม่ (ห้ามยิงซ้ำ)
    Console.WriteLine($"เข้าห้องรอ — คิวรวม {body.GetProperty("heldCount").GetInt32()} ใบ");
else
    Console.WriteLine($"บันทึกแล้ว {body.GetProperty("orderNo").GetString()}");

# ดูคิวออเดอร์ที่ค้างห้องรอ (โควตาเต็ม) — เรียงตามลำดับที่ระบบจะปล่อยเข้า
curl -s https://istatus.net/api/v1/orders/held \
  -H "Authorization: Bearer $ISTATUS_API_KEY" | jq

$held = istatus_get('/api/v1/orders/held');
echo $held['heldCount'] . ' ใบรอเข้า';

const held = await istatusGet('/api/v1/orders/held');
console.log(held.heldCount, 'ใบรอเข้า');

held = istatus_get("/api/v1/orders/held")
print(held["heldCount"], "ใบรอเข้า")

var held = await IstatusClient.GetAsync("/api/v1/orders/held");
Console.WriteLine($"{held.GetProperty("heldCount").GetInt32()} ใบรอเข้า");

# ตั้งยอดคงเหลือของ A-001 เป็น 42 ชิ้น (absolute ไม่ใช่บวก/ลบ)
istatus_send PUT /api/v1/stock/A-001 '{"qty": 42, "note": "sync จาก ERP"}'

$r = istatus_send('PUT', '/api/v1/stock/' . rawurlencode('A-001'), [
    'qty'  => 42,                  // ยอดคงเหลือใหม่ (ไม่ใช่ผลต่าง)
    'note' => 'sync จาก ERP',
]);
echo $r['body']['adjusted'] ? "ปรับ {$r['body']['delta']} ชิ้น" : 'ยอดตรงอยู่แล้ว';

const r = await istatusSend('PUT', `/api/v1/stock/${encodeURIComponent('A-001')}`, {
  qty: 42,                         // ยอดคงเหลือใหม่ (ไม่ใช่ผลต่าง)
  note: 'sync จาก ERP',
});
console.log(r.body.adjusted ? `ปรับ ${r.body.delta} ชิ้น` : 'ยอดตรงอยู่แล้ว');

from urllib.parse import quote
status, body = istatus_send("PUT", "/api/v1/stock/" + quote("A-001", safe=""),
                            {"qty": 42, "note": "sync จาก ERP"})   # ยอดคงเหลือใหม่ (ไม่ใช่ผลต่าง)
print(f"ปรับ {body['delta']} ชิ้น" if body["adjusted"] else "ยอดตรงอยู่แล้ว")

var (_, body) = await IstatusClient.SendAsync(HttpMethod.Put,
    "/api/v1/stock/" + Uri.EscapeDataString("A-001"),
    new { qty = 42, note = "sync จาก ERP" });      // ยอดคงเหลือใหม่ (ไม่ใช่ผลต่าง)
Console.WriteLine(body.GetProperty("adjusted").GetBoolean()
    ? $"ปรับ {body.GetProperty("delta").GetInt32()} ชิ้น" : "ยอดตรงอยู่แล้ว");