API Reference
Toàn bộ endpoint của GOCheap Open API v1, sinh trực tiếp từ đặc tả OpenAPI.
| Base URL (sandbox) | https://api-stag.gocheap.vn/open-api/v1 |
| Xác thực | Authorization: ApiKey gc_test_... (chi tiết) |
| Định dạng | JSON UTF-8, tiền tính bằng đồng (quy ước) |
Gọi thử ngay trên trang
Nút Try in Playground ở mỗi endpoint gửi request thật tới sandbox bằng key bạn nhập (gc_test_...). Playground không gọi được production nên không tạo chuyến thật. Key chỉ nằm trong trình duyệt của bạn, không gửi về máy chủ tài liệu.
Endpoint
| Method | Path | Mô tả |
|---|---|---|
GET | /services | Danh sách dịch vụ được mở |
GET | /places/search | Tìm địa chỉ |
POST | /quotes | Báo giá |
POST | /bookings | Tạo chuyến |
GET | /bookings | Danh sách chuyến |
GET | /bookings/{booking_id} | Xem chuyến |
POST | /bookings/{booking_id}/cancel | Huỷ chuyến |
GET | /webhooks | Danh sách webhook |
POST | /webhooks | Tạo webhook |
GET | /webhooks/{webhook_id} | Xem webhook |
PATCH | /webhooks/{webhook_id} | Sửa webhook |
DELETE | /webhooks/{webhook_id} | Xoá webhook |
POST | /webhooks/{webhook_id}/test-event | Gửi sự kiện thử |
Sự kiện gửi đi
| Sự kiện | Mô tả |
|---|---|
| Sự kiện trạng thái chuyến | GOCheap gửi tới URL webhook của bạn khi chuyến đổi trạng thái |