关联账号

让用户体验无缝链接

当用户没有通过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": "[e-mail]",
        "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账号的所有关联官网账号。