🔌 API 参考

供脚本与集成使用的小型 JSON API。在账户 → API 密钥创建密钥（仅显示一次）。可用 'Authorization: Bearer ling_…' 头或 api_key 表单/查询参数传递。请求为表单编码，响应为 JSON，金额为最小货币单位整数。

GET/api/v1/ping

存活检查（无需认证）。

GET/api/v1/me

店名、你的用户名、记账币种。

GET/api/v1/products

完整商品目录（含已下架），包含双语字段。

POST/api/v1/products

按 SKU 创建或更新。字段：sku、name、price_cents（必填）；name_zh、description、description_zh、kind=product|service、currency、tax_percent、requires_shipping=1、stock、emoji。jadePOS live 模式下会自动同步。

GET/api/v1/orders

订单按最新在前，每页 50 条（?page=N，?status=paid|pending|refunded|void）。包含发货状态、快递单号与关联的 jadePOS 编号。

cURL

curl https://sannyling.store/api/v1/products \
  -H "Authorization: Bearer ling_..."

curl -X POST https://sannyling.store/api/v1/products \
  -H "Authorization: Bearer ling_..." \
  -d sku=tea-jasmine -d name="Jasmine tea" -d name_zh="茉莉花茶" \
  -d price_cents=1250 -d requires_shipping=1

🟢 jadePOS

银行卡支付与后台账本由 jadePOS JSON API 驱动。完整文档见 jadepos.store/docs/api.