美洽工作台提供单点登录对接方案,企业可以根据业务需要,在自己内部系统中嵌入美洽工作台登录入口,然后由技术人员进行底层的账号对接。
对接完成后企业客服人员就可以在内部系统一键登录美洽工作台。
1、对接图示
2、说明
(1)获取 Access Token
由企业租户管理员从美洽工作台获取(设置->开发者->APIs)。
(2)美洽客服邮箱
企业租户管理员需保证:用户邮箱与美洽客服邮箱是一致的。
(3)获取临时登录URL
请求方法:POST
请求地址:https://api.meiqia.com/unified-api/session/v1/sso/login-urls
请求参数:
Header:
参数 | 类型 | 必填 | 备注 |
---|---|---|---|
Authorization | string | 是 | Access Token格式如下:Authorization: Bearer <Access-Token> |
Body:
参数 | 类型 | 必填 | 备注 |
---|---|---|---|
agent_email | string | 是 | 美洽客服邮箱 |
响应参数:
参数 | 类型 | 必填 | 备注 |
---|---|---|---|
url | string | 是 | 临时登录 URL(有效期2分钟) |
请求示例:
curl https://api.meiqia.com/unified-api/session/v1/sso/login-urls
-X POST
-H 'Content-Type: application/json'
-H 'Authorization:Bearer ba2a47********9152'
-d '{
"agent_email": "test@meiqia.com"
}'
响应示例(成功):
200 OK
{
"url": "https://app.meiqia.com/open-sso/login?token=eyJhbG*******pXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwiYWdlbnRfaWQiOiIxOTYxMzE2IiwiaWF0IjoxNTE2MjM5MDIyfQ.keELWFuVyKDOav2WcSytOermWJWfB8ZBkFN4WIZHUKc"
}
响应示例(失败1):
401 Unauthorized
{
"error": {
"code": "Unauthenticated",
"message": "Access Token 无效"
}
}
响应示例(失败2):
400 Bad Request
{
"error": {
"code": "InvalidArgument",
"message": "客服邮箱不存在"
}
}