开发者
B2B API 文档
nwp.ae 背后的 B2B API:以净价为您的客户询价和预订、签发凭证、运营酒店服务台、企业用车和 DMC 行程,并随时获取您的价格、对账单和发票。早期接入:沙盒密钥返回带标注的测试数据,正式密钥在审核通过后签发。
状态早期接入 · 仅限沙盒
沙盒按真实的数据结构校验真实请求,并以测试数据响应。不会产生预订,不会占用车辆,也不返回价格。沙盒不附带任何服务等级承诺;API 正式开放时,向已审核的合作伙伴发放生产密钥。
申请早期接入概览
JSON over HTTPS。请发送 Content-Type: application/json。每个响应均为 JSON,并带有 x-request-id 标头,联系同业服务台时请提供该值;沙盒响应还带有 x-nwp-environment: sandbox。
| 基础 URL | — |
|---|---|
| 沙盒 | https://nwp.ae/api/b2b/sandbox |
| 生产环境 | https://nwp.ae/api/b2b/v1尚未开放 · 需要正式密钥——审批通过后签发 |
B2B API v1
一个 API 涵盖账户的全部操作:按您的商务条款(净价、佣金或协议价)定价的地面交通与游览活动、为客户预订、凭证和接机牌、酒店服务台、企业用车、DMC 行程、预订插件、用户、通知、对账单和发票。沙盒密钥(nwp_test_…)向申请者开放:在每个端点返回标记为 sandbox: true 的测试数据,从不产生预订,也不会更改您的账户。正式密钥(nwp_live_…)在审核通过后签发,待 NWP 为您的账户开通正式访问后即可使用。每个 POST 接受 Idempotency-Key,每个响应带有 x-request-id,每个密钥有各自的每分钟限额。
OpenAPI 3.1 文档: /api/b2b/v1/openapi.json
地面交通
POST/api/b2b/v1/transport/quote按您的条款报价
权限范围:
transport:readPOST/api/b2b/v1/transport/bookings预订
权限范围:
transport:write需要正式密钥——审批通过后签发GET/api/b2b/v1/transport/bookings/{id}预订状态与取消条款
权限范围:
transport:readPOST/api/b2b/v1/transport/bookings/{id}/cancel按政策取消
权限范围:
transport:write需要正式密钥——审批通过后签发GET/api/b2b/v1/transport/bookings/{id}/voucher带您品牌的凭证(HTML 或 PDF)
权限范围:
transport:read
游览与活动
GET/api/b2b/v1/activities/products在售产品,按人或按车计价
权限范围:
activities:readGET/api/b2b/v1/activities/products/{id}/availability每日可订情况
权限范围:
activities:readPOST/api/b2b/v1/activities/quote按您的条款报价
权限范围:
activities:readPOST/api/b2b/v1/activities/bookings预订
权限范围:
activities:write需要正式密钥——审批通过后签发GET/api/b2b/v1/activities/bookings/{id}预订状态与取消条款
权限范围:
activities:readPOST/api/b2b/v1/activities/bookings/{id}/cancel按政策取消
权限范围:
activities:write需要正式密钥——审批通过后签发GET/api/b2b/v1/activities/bookings/{id}/voucher带您品牌的凭证(HTML 或 PDF)
权限范围:
activities:read
邮轮
GET/api/b2b/v1/cruise/sailings航次
权限范围:
cruise:read尚未开放:接入邮轮供应商之前返回 501POST/api/b2b/v1/cruise/quote按您的条款报价
权限范围:
cruise:read尚未开放:接入邮轮供应商之前返回 501POST/api/b2b/v1/cruise/bookings预订
权限范围:
cruise:write尚未开放:接入邮轮供应商之前返回 501GET/api/b2b/v1/cruise/bookings/{id}预订状态与取消条款
权限范围:
cruise:read尚未开放:接入邮轮供应商之前返回 501POST/api/b2b/v1/cruise/bookings/{id}/cancel按政策取消
权限范围:
cruise:write尚未开放:接入邮轮供应商之前返回 501
入住指南
GET/api/b2b/v1/guides/properties您的房源
权限范围:
guides:readPOST/api/b2b/v1/guides/properties添加房源
权限范围:
guides:writeGET/api/b2b/v1/guides/properties/{id}房源指南、链接和文件
权限范围:
guides:readPATCH/api/b2b/v1/guides/properties/{id}编辑房源
权限范围:
guides:writePOST/api/b2b/v1/guides/properties/{id}/status暂停或恢复指南
权限范围:
guides:writePOST/api/b2b/v1/guides/properties/{id}/link更换住客链接
权限范围:
guides:writeGET/api/b2b/v1/guides/properties/{id}/wifi读取 Wi-Fi 信息
权限范围:
guides_wifi:readPOST/api/b2b/v1/guides/properties/{id}/wifi设置 Wi-Fi
权限范围:
guides_wifi:writeGET/api/b2b/v1/guides/properties/{id}/qr二维码(PNG 或 SVG)
权限范围:
guides:readGET/api/b2b/v1/guides/properties/{id}/card可打印卡片(PDF 或 HTML)
权限范围:
guides:readGET/api/b2b/v1/guides/stats扫码、浏览、预订与您的分成
权限范围:
guides:read
账户
GET/api/b2b/v1/whoami检查密钥
权限范围:
account:readGET/api/b2b/v1/openapi.json本 API 的 OpenAPI 3.1 文档
推广联盟
GET/api/b2b/v1/affiliate/stats某一期间的统计:点击、预订、转化率、收益
权限范围:
affiliate:readGET/api/b2b/v1/affiliate/links您的追踪链接及 QR 码
权限范围:
affiliate:readPOST/api/b2b/v1/affiliate/links生成带 UTM 参数的追踪链接
权限范围:
affiliate:write需要正式密钥——审批通过后签发GET/api/b2b/v1/affiliate/links/{code}/qr单个链接的 QR 码(SVG 或 PNG)
权限范围:
affiliate:readGET/api/b2b/v1/affiliate/performance按链接统计的点击、预订和收益
权限范围:
affiliate:readGET/api/b2b/v1/affiliate/payouts待付余额与付款申请
权限范围:
affiliate:readPOST/api/b2b/v1/affiliate/payouts申请付款,通过银行转账支付
权限范围:
affiliate:write需要正式密钥——审批通过后签发POST/api/b2b/v1/affiliate/payouts/{reference}/cancel撤回付款申请
权限范围:
affiliate:write需要正式密钥——审批通过后签发POST/api/b2b/v1/affiliate/bank-details保存银行信息(只写,不会返回)
权限范围:
affiliate:write需要正式密钥——审批通过后签发GET/api/b2b/v1/affiliate/widget插件设置与代码片段
权限范围:
affiliate:readPOST/api/b2b/v1/affiliate/widget设置预订插件
权限范围:
affiliate:write需要正式密钥——审批通过后签发
为客户预订
POST/api/b2b/v1/bookings/quote按您的条款报价
权限范围:
bookings:createPOST/api/b2b/v1/bookings预订
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/bookings列表
权限范围:
bookings:viewGET/api/b2b/v1/bookings/credited计入您账户的预订
权限范围:
bookings:viewGET/api/b2b/v1/bookings/{ref}详情
权限范围:
bookings:viewPOST/api/b2b/v1/bookings/{ref}/cancel按政策取消
权限范围:
bookings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/bookings/{ref}/amendments向同业服务台申请变更
权限范围:
bookings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/bookings/{ref}/brand单据上使用您的品牌,或不带品牌
权限范围:
bookings:manage需要正式密钥——审批通过后签发GET/api/b2b/v1/bookings/{ref}/voucher带您品牌的凭证(HTML 或 PDF)
权限范围:
bookings:viewGET/api/b2b/v1/bookings/{ref}/name-board司机接机牌(HTML)
权限范围:
bookings:viewGET/api/b2b/v1/requests变更与服务申请,附服务台答复
权限范围:
bookings:viewPOST/api/b2b/v1/requests/{id}/withdraw撤回未处理的申请
权限范围:
bookings:manage需要正式密钥——审批通过后签发
酒店服务台
POST/api/b2b/v1/desk/sales服务台快速销售
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/desk/days/{date}某日销售,或该日结算(CSV 或 PDF)
权限范围:
statements:readPOST/api/b2b/v1/desk/days/{date}/close日结并锁定结算
权限范围:
statements:read需要正式密钥——审批通过后签发
企业用车
GET/api/b2b/v1/corporate/cost-centres列表
权限范围:
bookings:viewPOST/api/b2b/v1/corporate/cost-centres创建或修改
权限范围:
settings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/corporate/cost-centres/{id}/approvers创建或修改
权限范围:
settings:manage需要正式密钥——审批通过后签发GET/api/b2b/v1/corporate/requests列表
权限范围:
bookings:viewPOST/api/b2b/v1/corporate/requests预订
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/corporate/requests/{id}/decision批准或拒绝
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/corporate/shuttles列表
权限范围:
bookings:viewPOST/api/b2b/v1/corporate/shuttles创建或修改
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/corporate/shuttles/{id}/status更改状态
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/corporate/shuttles/{id}/schedule安排一个月的班次
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/corporate/shuttles/{id}/reprice采用新议定的价格
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/corporate/usage按成本中心统计用量(JSON 或 CSV)
权限范围:
statements:read
DMC 行程
GET/api/b2b/v1/dmc/programmes列表
权限范围:
bookings:viewPOST/api/b2b/v1/dmc/programmes创建或修改
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/dmc/programmes/{id}详情
权限范围:
bookings:viewPOST/api/b2b/v1/dmc/programmes/{id}/versions保存一个已定价版本
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/dmc/programmes/{id}/status更改状态
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/dmc/programmes/{id}/brand单据上使用您的品牌,或不带品牌
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/dmc/programmes/{id}/accept接受某个版本并预订
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/dmc/programmes/{id}/proposal客户方案(HTML)
权限范围:
bookings:viewPOST/api/b2b/v1/dmc/programmes/{id}/links生成有有效期的客户链接
权限范围:
bookings:create需要正式密钥——审批通过后签发GET/api/b2b/v1/dmc/programmes/{id}/links客户链接及接受人
权限范围:
bookings:viewPOST/api/b2b/v1/dmc/programmes/{id}/links/{link}/revoke撤销客户链接
权限范围:
bookings:create需要正式密钥——审批通过后签发
价格与报价申请
GET/api/b2b/v1/rates/catalogue按您的价格提供的产品目录(JSON、CSV 或 PDF)
权限范围:
rates:viewGET/api/b2b/v1/rates/sheet服务价目表
权限范围:
rates:viewPOST/api/b2b/v1/quote-requests发送报价申请
权限范围:
bookings:create需要正式密钥——审批通过后签发POST/api/b2b/v1/wholesale-requests申请车辆运力
权限范围:
bookings:create需要正式密钥——审批通过后签发
预订插件
GET/api/b2b/v1/widget插件设置与代码片段
权限范围:
tracking:viewPOST/api/b2b/v1/widget修改插件
权限范围:
tracking:manage需要正式密钥——审批通过后签发
用户
GET/api/b2b/v1/users列表
权限范围:
users:viewPOST/api/b2b/v1/users邀请成员
权限范围:
users:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/users/{id}/role更改成员角色
权限范围:
users:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/users/{id}/deactivate停用成员访问权限
权限范围:
users:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/users/{id}/reactivate恢复成员访问权限
权限范围:
users:manage需要正式密钥——审批通过后签发
通知
GET/api/b2b/v1/inbox有关您账户的通知
权限范围:
inbox:view
对账单与发票
GET/api/b2b/v1/statements对账单、余额和未结发票
权限范围:
statements:readGET/api/b2b/v1/statements/{period}单月对账单(JSON 或 PDF)
权限范围:
statements:readGET/api/b2b/v1/invoices/{id}单张发票(JSON 或 PDF)
权限范围:
statements:read
账户设置
GET/api/b2b/v1/settings账户资料、联系人和账单邮箱
权限范围:
settings:viewPOST/api/b2b/v1/settings/billing-email设置账单邮箱
权限范围:
settings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/settings/contacts添加或修改联系人
权限范围:
settings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/settings/contacts/{id}/remove删除联系人
权限范围:
settings:manage需要正式密钥——审批通过后签发POST/api/b2b/v1/settings/brand单据上使用您的品牌,或不带品牌
权限范围:
settings:manage需要正式密钥——审批通过后签发
curl -X POST 'https://nwp.ae/api/b2b/v1/transport/quote' \
-H 'Authorization: Bearer nwp_test_…' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: 7f1c2b0e-quote-1' \
-d '{"airport":"dxb","terminal":"t3","direction":"from_airport","place":"downtown","vehicle":"vclass","pickup_date":"2026-11-02","pickup_time":"14:30","passengers":3,"bags":3}'身份验证
每次沙盒调用都需要 bearer 令牌。令牌通过开发者握手(handshake)获取:一个 JWT 格式、以 nwp_sandbox_ 开头的令牌,有效期 30 天,只能访问测试数据。
1申请沙盒令牌
curl -X POST https://nwp.ae/api/b2b/orchestration \
-H 'Content-Type: application/json' \
-d '{
"action": "developer_handshake",
"platform_name": "Example Travel App",
"contact_email": "developers@example.com",
"use_case": "transfers"
}'{
"environment": "sandbox",
"status": "early-access",
"test_data": true,
"token_type": "Bearer",
"token": "nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…",
"expires_at": "2026-10-31T08:00:00.000Z",
"scopes": [
"sandbox:transfers.quote",
"sandbox:availability.read"
],
"endpoints": [
{
"method": "POST",
"url": "https://nwp.ae/api/b2b/sandbox/transfers"
},
{
"method": "GET",
"url": "https://nwp.ae/api/b2b/sandbox/availability"
},
{
"method": "GET",
"url": "https://nwp.ae/api/b2b/sandbox/status"
}
],
"production": {
"status": "not_open",
"request_access": "https://nwp.ae/register?type=institutional"
}
}2使用令牌调用沙盒
curl -X POST https://nwp.ae/api/b2b/sandbox/transfers \
-H 'Authorization: Bearer nwp_sandbox_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImVudiI6InNhbmRib3gifQ…' \
-H 'Content-Type: application/json' \
-d @transfer.json接送请求
将以下字段发送到沙盒接送端点。字段名属于 API 的一部分,在所有语言中都保持英文。
pickup_location必填{ type: "airport" | "coordinates" | "hotel", … }乘客上车地点:机场航站楼(DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)、阿联酋境内的坐标,或酒店参照。
dropoff_location必填{ type: "hotel" | "coordinates" | "airport", … }乘客送达地点:酒店参照字符串(您自己的酒店代码或酒店名称)、坐标,或机场航站楼。
flight_number条件必填string到达航班,例如 EK202。接车时间按该航班的计划落地时间安排。
pickup_at条件必填string (ISO 8601)带时区偏移的 ISO 8601 时间。上车地点不在机场,或机场接车没有航班时必填。
buffer_minutes_override选填integer落地后的免费等候时间,以分钟计,取值 0 至 180。默认值为 60:即集团接送网站为每个到达航班提供的免费等候时间。
vehicle_class必填enum取值之一:VIP_V_CLASS、EXECUTIVE_SEDAN或LUXURY_COACH。
passengers选填integer超过该级别座位数时将被拒绝。
client_metadata选填object旅客凭证的白标信息:agency_name、logo_url(仅限 https)、voucher_branding 和 agency_reference。
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
pickup_location | { type: "airport" | "coordinates" | "hotel", … } | 必填 | 乘客上车地点:机场航站楼(DXB_T1, DXB_T2, DXB_T3, DWC, SHJ)、阿联酋境内的坐标,或酒店参照。 |
dropoff_location | { type: "hotel" | "coordinates" | "airport", … } | 必填 | 乘客送达地点:酒店参照字符串(您自己的酒店代码或酒店名称)、坐标,或机场航站楼。 |
flight_number | string | 条件必填 | 到达航班,例如 EK202。接车时间按该航班的计划落地时间安排。 |
pickup_at | string (ISO 8601) | 条件必填 | 带时区偏移的 ISO 8601 时间。上车地点不在机场,或机场接车没有航班时必填。 |
buffer_minutes_override | integer | 选填 | 落地后的免费等候时间,以分钟计,取值 0 至 180。默认值为 60:即集团接送网站为每个到达航班提供的免费等候时间。 |
vehicle_class | enum | 必填 | 取值之一:VIP_V_CLASS、EXECUTIVE_SEDAN或LUXURY_COACH。 |
passengers | integer | 选填 | 超过该级别座位数时将被拒绝。 |
client_metadata | object | 选填 | 旅客凭证的白标信息:agency_name、logo_url(仅限 https)、voucher_branding 和 agency_reference。 |
{
"pickup_location": {
"type": "airport",
"terminal": "DXB_T3"
},
"dropoff_location": {
"type": "hotel",
"hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
},
"flight_number": "EK202",
"buffer_minutes_override": 60,
"vehicle_class": "VIP_V_CLASS",
"passengers": 4,
"client_metadata": {
"agency_name": "Example Travel",
"logo_url": "https://example.com/logo.png",
"voucher_branding": {
"mode": "white_label",
"accent_hex": "#0A0A0A"
},
"agency_reference": "EX-10442"
}
}车辆级别
| 级别 | 车辆 | 座位 |
|---|---|---|
VIP_V_CLASS | Mercedes-Benz V-Class or similar | 7 |
EXECUTIVE_SEDAN | Lexus ES 350 or a similar executive saloon | 3 |
LUXURY_COACH | Toyota Coaster or King Long coach | 30 |
每辆车都连同其持牌司机为该任务雇用;级别决定车辆类型和座位数。
响应
沙盒报价会回显请求,并补充接车时间的安排方式和凭证的品牌呈现方式。其中从不包含价格。
{
"environment": "sandbox",
"test_data": true,
"notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
"quote_id": "SBX-WT5PCXWF",
"status": "sandbox_accepted",
"vehicle": {
"class": "VIP_V_CLASS",
"description": "Mercedes-Benz V-Class or similar",
"max_passengers": 7
},
"passengers": 4,
"pickup": {
"location": {
"type": "airport",
"terminal": "DXB_T3"
},
"timing": {
"mode": "flight_landing",
"flight_number": "EK202",
"driver_ready": "at the scheduled landing time",
"free_waiting_minutes": 60,
"live_arrival_tracking": "planned"
}
},
"dropoff": {
"location": {
"type": "hotel",
"hotel_ref": "EXAMPLE-HOTEL-DOWNTOWN"
}
},
"voucher": {
"branding": "white_label",
"agency_name": "Example Travel",
"logo_url": "https://example.com/logo.png",
"accent_hex": "#0A0A0A",
"footer_text": null,
"agency_reference": "EX-10442",
"shows_nwp_branding": false
},
"price": null,
"price_note": "Sandbox quotes carry no price. Net rates are issued to approved partners in the portal.",
"default_buffer_minutes": 60,
"created_at": "2026-10-01T08:00:00.000Z"
}{
"error": {
"code": "validation_failed",
"message": "One or more fields are invalid.",
"retryable": false,
"fields": [
"flight_number"
],
"issues": [
{
"path": "flight_number",
"message": "flight_number must be an airline flight number such as EK202."
}
]
},
"environment": "sandbox"
}航班时间
目前,接车时间按预订中的落地时间安排,司机在落地后的缓冲时间内免费等候。如航班变动,请告知同业服务台,接车时间将随之调整。
通过 FlightAware 或 AeroDataBox 自动实时追踪到达的功能在计划中。两者目前均未接入,沙盒将 live_arrival_tracking 报告为 planned(计划中)。
签名可用性
握手会返回一个带签名的可用性 URL。签名涵盖日期、车辆级别和过期时间;更改其中任何一项,调用都会被拒绝。其中的状态为供开发使用的示例。
curl 'https://nwp.ae/api/b2b/sandbox/availability?date=2026-10-15&vehicle_class=VIP_V_CLASS&expires=1760572800&sig=…'{
"environment": "sandbox",
"test_data": true,
"notice": "Sandbox response: test data only. Nothing is booked, no vehicle is held and no price is quoted. Production is not open yet.",
"date": "2026-10-15",
"vehicle_class": "VIP_V_CLASS",
"vehicle": {
"description": "Mercedes-Benz V-Class or similar",
"max_passengers": 7
},
"sample_status": "on_request",
"note": "A sample status for building against. Real availability is confirmed by the trade desk until the API opens."
}账户操作
携带操作向编排端点发送 POST 请求。需要人工处理的操作会先被存储并转交同业服务台,然后响应才会说明这一点。
| 操作 | 作用 |
|---|---|
credit_line_application | 为在阿联酋注册的公司提供 Net-15、30、45 或 60 账期。须提供营业执照号码和 TRN(15 位数字,以 100 开头)。每份申请均由专人审核,信用额度获批前预订须预付。 |
wallet_topup | 向您的账户预付款。目前尚不支持银行卡充值,因此由同业服务台向您开具银行转账发票,响应中也会说明这一点。 |
account_payload | 您账户的币种矩阵。AED 是基础币种,也是唯一的计费和收益币种;其他币种按网站每日汇率换算,仅供显示,因此利润不会因换算而变动。 |
tracking_link | 为度假屋和推广联盟等级生成的确定性合作伙伴 URL 和 QR 码,并清楚说明目前计入何处。 |
developer_handshake | 一个沙盒令牌、沙盒端点,以及一个带签名的可用性 URL。 |
{
"action": "credit_line_application",
"company_legal_name": "Example Travel L.L.C.",
"trade_licence_number": "1234567",
"licence_authority": "Department of Economy and Tourism, Dubai",
"trn": "100000000000003",
"contact_name": "Finance Desk",
"contact_email": "finance@example.com",
"requested_terms": "NET_30",
"requested_limit_aed": 50000
}{
"action": "wallet_topup",
"company_name": "Example Travel L.L.C.",
"contact_email": "finance@example.com",
"amount_aed": 10000,
"purchase_order": "PO-2291"
}{
"action": "account_payload",
"company_name": "Example Travel L.L.C.",
"tier": "Tier_4_Regional_DMCs",
"display_currencies": [
"USD",
"EUR"
],
"lines": [
{
"label": "Your own city-tour package",
"net_aed": 400,
"sell_aed": 560
}
]
}{
"action": "tracking_link",
"partner_code": "HHO-EXAMPLE",
"tier": "Tier_1_Holiday_Homes",
"property_id": "marina-2104",
"destination": "dubaitransfers.ae"
}错误
所有错误格式相同:error.code、error.message 和 error.retryable;校验失败时另含 fields 和 issues。
| 状态码 | 代码 | 含义 |
|---|---|---|
| 400 | invalid_json | 请求体不是有效的 JSON。 |
| 401 | unauthenticated | 缺少沙盒令牌,或令牌格式错误、已过期或签名不正确。 |
| 404 | not_found | 该主机上不存在此端点。 |
| 405 | method_not_allowed | 该端点接受其他请求方法。 |
| 413 | payload_too_large | 请求体超过 16 KB。 |
| 422 | validation_failed | 字段缺失或格式错误:请查看 fields 和 issues。 |
| 429 | rate_limited | 来自该地址的请求过多:请在 retry_after_seconds 之后重试。 |
| 500 | internal | 我们这边出现故障:请提供请求 ID。 |
| 502 | upstream_unavailable | 支付服务商未响应。 |
| 503 | not_configured | 请求无法存储:请发送电子邮件至同业服务台。 |
频率限制
账户操作按地址每小时限制:credit_line_application:5、wallet_topup:10、account_payload:60、tracking_link:60和developer_handshake:10。沙盒调用限制为每个地址每小时 120 次。
预订插件
预订插件已在抢先体验阶段向已审批的合作伙伴开放:一个 script 标签即可把 nwp.ae 的游览和接送以公开价格放到您的网站上,支持十二种语言,显示您的名称,每笔预订都带有您的合作伙伴代码。请通过 API 设置:预订插件的端点可读取和修改其设置,并返回可直接粘贴的代码片段。