关联账号
当用户没有通过Messneger登录按钮，而是通过其他途径（例如邮件订阅确认）确认了要将Facebook账号和官网账号的绑定之后，可以通过这个接口通知Bothub，这样用户就完成了关联，可以在Messenger里收到关联成功的确认，并在今后的使用中享受绑定带来的便利。
开发指南
发送请求
您可以用任意一个已经启用的API Key（怎样申请APIKey）向Bothub发起请求，向一个手机号发送一条消息。这个请求的样例如下：
| 请求属性 | 属性名 | 说明 |
|---|---|---|
| 地址 | https://api.bothub.ai/api | |
| 请求方式 | POST | |
| Header | APIKEY | 您的API KEY |
| Form Data | request.method | 需要调用的api。此处设置为 account_link |
| Form Data | request.id | 由调用者生成的请求的唯一标识符 |
| Form Data | recipient.id | 待关联的Facebook user id |
| Form Data | account_linking.username | 待关联的官网账号(用户名) |
| Form Data | account_linking.email | 待关联的官网账号(邮箱) |
| Form Data | account_linking.phone_number | 待关联的官网账号(电话号码) |
| Form Data | account_linking.status | 取值为linked表示确认绑定，unlinked表示确认解除绑定 |
| Form Data | request.meta | 预留数据 |
- 发送请求样例
{
"recipient": {
"id": "123456"
},
"timestamp": "1409291011",
"account_linking": {
"status": "linked",
"username": "myaccount",
"email": "mike@example.com",
"phone_number": "18900001111"
},
"request": {
"method": "account_link",
"id" : "F4js0Za2",
"meta": ""
}
}
返回值
| 返回值属性名 | 说明 |
|---|---|
| request_id | 请求的唯一标识符，和请求的同名属性相同 |
| result | 调用是否成功，true表示成功，false表示失败 |
| error_code | 错误码，0表示成功 |
| error_message | 错误信息 |
- 成功返回样例
{
'request_id': "F4js0Za2"
}
- 失败返回样例
{
"error" : {
"message": "Invalid Facebook user id",
"type": "InvalidParamException",
"code": 10000,
"error_subcode": 1234567,
"request_id": "F4js0Za2"
}
}
错误码
| 错误码 | 说明 |
|---|---|
| 10000 | 无效的method参数 |
| 10005 | 无效的API KEY |
| 13000 | 未指定fb_user_id |
| 13001 | 未指定任何一种绑定方式 |
| 13002 | 绑定的fb_user_id无效 |
| 13003 | 指定的status无效 |
调用说明
- 接口支持用户名，邮箱，电话号码三种形式之一或多个与Facebook账号进行绑定。调用此api时，username, email和phone_number至少要传一个。
- 此接口所指定的Facebook账号如果已经有绑定的账号了，那么会更新所绑定的官网账号。
- 此接口同样适用于用户先绑定邮箱，后续再绑定手机号这种情况。调用2次该接口，依序指定邮箱和手机号即可。
- 若调用此接口是为了解除绑定，则不需要传username，email或者phone_number，而是解除该Facebook账号的所有关联官网账号。