✈️ GYG API 适配层 — 实时监控

RELAX CAR SERVICE CO. LIMITED  ·  airport-taxi.com
刚刚加载 自动刷新:

服务状态

—

运行模式

—
调度系统

总请求数

0

已确认订单

0

已取消订单

0
GYG 取消

失败次数

0
book 接口错误

Token 剩余时间

0
seconds

🔗 字段映射表（GYG ↔ 调度系统）

完整映射
📋 预订字段
👤 乘客信息
📍 位置信息
⭐ 特殊映射
🔍 实时预览
调度系统字段
方向
GYG / 控制面板显示
bookId string
→
调度系统订单 ID（内部追踪）
groupId string
→
订单组 ID（批量订单关联）
bookingReference string
←
GYG Booking Reference（外部参考号）
status accepted/completed/cancelled
↔
订单状态同步
quoteStatus pending/accepted
→
报价状态
source string
←
固定值: "getyourguide"
vehicleType Sedan/SUV/Van...
↔
车型（GYG option title 映射）
vehicleIdentifier integer
→
车辆标识符
noPassengers integer
←
GYG paxMix 总人数
noLuggage integer
←
GYG 行李数量
pickupDateTime ISO 8601
←
GYG dateTime（含时区转换）
duration seconds
→
预计行程时长（秒）
trackLink URL
→
实时追踪链接
price.value float
↔
订单金额（GYG 最小货币单位 ÷ 100）
price.currency string
↔
货币代码（HKD/USD/JPY...）
调度系统字段
方向
GYG / 控制面板显示
booker.title
←
GYG traveller title
booker.firstName
←
GYG traveller firstName
booker.lastName
←
GYG traveller lastName
booker.phone
←
GYG traveller phone
booker.email
←
GYG traveller email
passenger.title
←
GYG traveller title（同 booker）
passenger.firstName
←
GYG traveller firstName
passenger.lastName
←
GYG traveller lastName
passenger.phone
←
GYG traveller phone
passenger.email
←
GYG traveller email
driver.firstName
→
分配司机姓名（Webhook 推送）
driver.lastName
→
分配司机姓名（Webhook 推送）
driver.phone
→
司机联系电话（Webhook 推送）
driver.avatar
→
司机头像 URL
vehicle.plateNumber
→
车牌号
vehicle.make
→
车辆品牌（Toyota/Mercedes...）
vehicle.model
→
车型（Camry/Vito...）
vehicle.color
→
车辆颜色
调度系统字段
方向
GYG / 控制面板显示
pickup.latitude
←
GYG pickupLocation.latitude
pickup.longitude
←
GYG pickupLocation.longitude
pickup.address
←
GYG pickupLocation.address
pickup.city
←
GYG pickupLocation.city
pickup.country
←
GYG pickupLocation.country（ISO 2字母）
pickup.postcode
←
GYG pickupLocation.postcode
destination.latitude
←
GYG dropoffLocation.latitude
destination.longitude
←
GYG dropoffLocation.longitude
destination.address
←
GYG dropoffLocation.address
destination.city
←
GYG dropoffLocation.city
destination.country
←
GYG dropoffLocation.country
destination.postcode
←
GYG dropoffLocation.postcode
⚠️ 以下字段有特殊映射规则，需要额外处理
调度系统字段
映射规则
目标位置
internalComment
"VIP client - priority service"
→
Driver Notes
GYG data.notes → 调度系统 comment 字段
flightNumber
"AA5633"
→
Flight Info
GYG data.flightNumber → 调度系统 flightNumber 字段
修改记录
每次 PATCH /1/book/ 更新
→
Booking Activity
调度系统 internalComment 追加变更日志
additionalServices
GYG Addons 列表
→
Additional Services
从 /1/products/:id/addons/ 选择并传入调度系统
corporate.id / corporate.name
企业客户信息
→
企业账户关联
映射到调度系统企业客户模块
supplierId
"RELAXCARSERVICECO.LIMITED"
→
供应商标识
固定值，用于多供应商路由
调度系统 API 实时字段预览
GET https://api.airport-taxi.com/api/demand/v1/bookings/{bookId}
输入调度系统 bookId 查询真实订单字段

💴 产品报价配置

加载中...
产品 ID模式路线套餐数加价规则截止时间最小提前
加载中...

🔌 GYG 附加功能端点

5 个端点
端点方法功能GYG 功能状态
/1/notify/POST订单状态通知 WebhookNOTIFICATION_WEBHOOKPASSED ✅
/1/get-availabilities/GET可用性 + 分类价格 + 分类余位PRICE_CATEGORIES + AVAILABILITY_BY_TICKET_CATEGORY待 GYG 确认
/1/suppliers/:id/products/GET产品列表PRODUCT_LIST_OVER_API待 GYG 确认
/1/products/:id/addons/GET附加服务列表ADDONS_OVER_APIPASSED ✅
📋 实时活动
📄 系统日志
📋 预留记录
时间类型GYG 参考号详情
暂无活动
预留参考号GYG 参考号状态调度系统 ID乘客时间
暂无记录

🔌 API 端点状态

端点方法功能状态
/1/get-availabilities/GET可用性查询（集成报价引擎）运行中
/1/reserve/POST预留运行中
/1/book/POST确认订单运行中
/1/cancel-reservation/POST取消预留运行中
/1/cancel-booking/POST取消订单运行中
/healthGET健康检查运行中
/api/pricingGET产品报价列表运行中
/api/pricing/:idGET/POST/PATCH/DELETE产品报价管理运行中
/api/pricing/:id/previewPOST报价预览运行中