为了让合作伙伴在通过 API 集成时能够把关键数据回写到百居易系统,我们在订单接口里开放了 自定义字段 功能。
典型使用场景
越来越多的服务商通过 API 接入百居易。例如智能门锁服务商希望把自动生成的门锁密码回写给房东,让房东直接在百居易后台看到并使用。
为此我们开放了以下两个接口,让合作伙伴 读取和更新 订单上的自定义字段:
在自动化消息中使用
自定义字段最常见的用途是在 自动化消息模板 中被引用。为此我们提供了 短代码自动映射机制。
一旦在订单上设置了某个自定义字段(例如 my_lockcode),就可以在自动化消息里通过下面的语法引用:{{cf.my_lockcode}}
只要在字段名前加上 cf. 前缀,发送消息时百居易会自动用对应字段的值填充——不需要额外的配置。
