房源和照片
五大类房源、房间库存、照片和您语言的描述，我们会翻译成四种语言。
POST /v1/listings
三步迎来首批预订
- 01 合作伙伴账户 注册开放。填写企业资料，经审核员审核后即可开通后台。
- 02 在后台创建 API 密钥 公司 → 开发者。像给员工授权一样选择板块和权限级别。密钥无需登录或验证码。
- 03 由您的开发人员接入 文档公开，每个接口都有示例。最方便的做法是在尚未发布的房源上测试接入。
合作伙伴 API 能做什么
合作伙伴后台的全部功能，员工、公司文件和收款信息除外。
日历和关房
在您系统中已被占用？一个请求即可关闭日期或房间，一次最多 50 个时间段。
PUT /v1/listings/{id}/availability
价格和规则
每日价格、最少晚数、房价方案、附加项和价格规则，即客人账单上的内容。
PUT /v1/listings/{id}/pricing
预订和入住
新预订、确认与拒绝、客人信息、扫码入住、退房和未到店。
POST /v1/bookings/{id}/confirm
客人沟通
在您的系统中阅读和回复，我们负责翻译成客人的语言。
POST /v1/dialogs/{id}/messages
评价和财务
回复评价、扣款、结算和周期报表。
GET /v1/finance/payouts
Webhook
几秒内获知新预订和客人消息，无需轮询。
booking.createdbooking.confirmedbooking.cancelledmessage.new
更多连接方式
没有开发者？从 iCal 开始
每个房间的日历链接放到 Airbnb、Booking.com 或您的 PMS，它们的日历接到我们这里。已占用日期自动同步，在后台设置只需十分钟。
GET /v1/ical/{secret}.ics
数百个房间，一个任务
一次为多个房源创建和更新房源（含房间和链接照片）、关闭日期、修改价格：任务在后台运行，报告会列出失败项及原因。
POST /v1/bulk/listings
面向集成商
为多个商家开发 PMS 或渠道管理模块？我们会根据申请登记您的应用：一个密钥，每个商家在自己的后台授权，随时可以断开。
X-Bounty-Partner: {id}
联系我们
适用对象
API 向 Bounty 上的每家企业开放，从一栋别墅到连锁酒店。密钥免费，在后台一分钟即可生成。没有程序员？一个 iCal 链接或现成的集成商模块就够了。
-
管理数十套别墅和公寓的物业公司
一个任务即可关闭数百间房的日期并修改价格，并通过每间房的 iCal 同步 Airbnb 和 Booking.com 的占用。
POST /v1/bulk/calendarGET /v1/ical/{secret}.ics -
拥有自己 PMS 的酒店和公寓式酒店
Bounty 客人的预订通过 webhook 几秒内送达您的 PMS，房间和价格方案按您自己的编码对应。
POST /v1/webhooksPUT /v1/external-refs -
房产和长租中介
一次上传即可创建带照片的房源，重复上传不会产生重复；长租合同使用同一个密钥。
POST /v1/bulk/listings/v1/listings/{id}/contracts -
拥有自己 CRM 的租赁、旅游和餐厅
场次和价格来自您的 CRM，客人的预订和消息回传到 CRM。
/v1/listings/{id}/slotsGET /v1/dialogs -
PMS 对接模块和渠道管理器的开发者
一个模块服务多个合作伙伴：应用有自己的权限，每家企业一次授权即可接入。
PUT /v1/apps/{code}/grant
保护您预订的规则
密钥只显示一次
Bounty 只保存密钥指纹。一键撤销，立即失效。
按板块授权
日历密钥无需读取消息或财务，只授予必要权限。
重试不会重复
使用 Idempotency-Key 请求头，同一请求发送两次只产生一条记录和相同响应。
日期使用房源时区
12 月 20 日入住即普吉岛的 12 月 20 日，而非 UTC，不会出现“早一天”的错误。
每分钟 600 个请求
按每个密钥计。超出返回 429 及重试等待时间。
/v1 保持兼容
会新增字段和接口；破坏性变更只出现在 /v2，此后 /v1 至少继续运行一年。
用户 API
用于您自己的脚本和助手：以您的名义搜索、预订、收藏和沟通。令牌通过带密码的请求签发，权限可选。
POST /v1/me/api-tokens