Webhooks — Tier A nhận gì
Ba khái niệm khác nhau trong repo. Integrator Tier A (public API) chỉ cần hàng đầu cho job media.
| Loại | Tier A (public API) | Doc |
|---|---|---|
| Job xong (ảnh/video/…) | Không — app poll | Vòng đời request · FAQ |
| Thanh toán / nạp credit | Không thuộc hợp đồng integrator mặc định | Billing (operator) · Roadmap |
| Webhook job ra HTTPS (gateway → bạn) | Chưa trên public API — preview self-host | Observability (preview) |
Quy tắc
Tích hợp v2.api.gommo.net không self-host gateway → POST /ai/jobs/{id}?media=… poll — không webhook job xong.
Job media (Tier A)
Gommo không push “job done” lên server bạn trên flow public chuẩn.
POST /ai/jobs/{type}/{model}→ id- Poll đến
result_url/ lỗi — Vòng đời request
Mode B (deploy repo): wait: true hoặc webhook observability (preview) — không bắt buộc Tier A.
Webhook thanh toán (operator)
/billing/webhook/payos báo gateway khi checkout đã trả — không phải “ảnh render xong”.
Webhook observability gateway (preview)
Portal Observability đăng ký URL nhận JSON khi gateway REST poll xong job. Beta — Observability.
Sắp có trên nền tảng Gommo
Preview trên site này. Khi Gommo ship chính thức, dùng doc/domain Gommo — không phụ thuộc self-host cứng.
Nhầm lẫn thường gặp
| Nhầm | Thực tế |
|---|---|
| Chờ Gommo POST khi video xong | Poll (hoặc self-host) |
PayOS webhook trúng v2.api.gommo.net | Sai host — billing api.gommo.net / gateway operator |
| Bật Observability webhook nhưng app gọi public API | Webhook chỉ cho route gateway bạn vận hành |