单点登录

美洽工作台提供单点登录对接方案，企业可以根据业务需要，在自己内部系统中嵌入美洽工作台登录入口，然后由技术人员进行底层的账号对接。

对接完成后企业客服人员就可以在内部系统一键登录美洽工作台。

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": "客服邮箱不存在"
  }
}