คู่มือ integrator (Tier A)
Tier A หมายถึงผลิตภัณฑ์เรียก Gommo public API โดยตรง (v2.api.gommo.net + api.gommo.net) — ไม่จำเป็น gateway/portal หรือ /gateway/* ของ repo นี้
ผู้ดำเนินการ / dealer
Self-host Gommo Developer (portal, /billing/*, BYOK, observability) เป็น ทางเลือก — ดู Deploy และ Portal & preview ไม่ใช่สัญญา integration เริ่มต้น
เริ่มต้น
| ขั้น | Doc |
|---|---|
| 1 | หลักการ — สองโฮสต์ Bearer job async |
| 2 | Authentication — login domain = โดเมนลงทะเบียน |
| 3 | Quickstart — image job หนึ่งงาน |
| 4 | วงจร request — create → poll → ผลลัพธ์ |
| 5 | ข้อผิดพลาดที่พบบ่อย · Webhooks — Tier A poll เท่านั้น |
| 6 | Cookbook — recipe copy-paste (URL public) |
| 7 | TypeScript SDK — เส้นทาง 5 นาที (createAndWait) |
| 8 | อ่านแคตตาล็อก · Models — ไม่เดา ratio / mode |
โดเมนลงทะเบียน (สำคัญ)
ฟิลด์ domain คือที่ผู้ใช้ สมัคร บน Gommo (dealer) — ไม่ใช่ api.gommo.net หรือ v2.api.gommo.net
| ในตัวอย่าง | ใช้ |
|---|---|
| curl.exe | %REGISTRATION_DOMAIN% |
| PowerShell | $env:GOMMO_API_DOMAIN (throw ถ้าไม่ตั้ง) |
| แอป | ค่าต่อผู้ใช้จาก flow สมัคร |
โดเมนผิด → auth/credit/billing dealer ผิด — ดู Authentication
Mode A vs self-host (B/C)
| Mode | ใคร | Base URL |
|---|---|---|
| A (Tier A) | Integrator production | https://v2.api.gommo.net, https://api.gommo.net |
| B/C | Operator รัน repo | {api-คุณ}/gateway/* — Integration modes |
เอกสาร Tier A ใช้ Mode A — Mode B/C อยู่ใต้ Deploy → Self-host (advanced) เท่านั้น
Preview เฉพาะ gateway
ฟีเจอร์ที่ ยังไม่ อยู่บน public Gommo (BYOK, webhook observability, billing portal, …) มีแบนเนอร์ Coming to Gommo platform + roadmap
แคตตาล็อก EN (?lang=en)
npm run catalog:translate
npm run catalog:translate-th
npm run catalog:cache-smokeChecklist: doc/CATALOG-TEST.md ใน repo
Maintainer (repo)
ก่อน merge docs:
npm run docs:smoke
npm run portal:smokenode scripts/normalize-domain-docs.mjs — checklist: doc/TRACK-C.md