Skip to content

Passport OpenAPI

接口说明

接入方获取Passport token凭证

1
POST /v1/org-user/{org_user_id}/token

说明

为接入方用户签发 UBI passport token。UBI Passport 同时为用户签发一个 UBI passport token,有效期为 7 天。

注意:如果 org_user_id 从未注册过或已被注销,则该接口会静默地创建一个新的账户。

参数

响应

HTTP 状态码 类型 说明
200 SuccessResult 请根据响应体中的 code 字段判断调用是否成功
400 ErrorResult 请求参数不合法
500 ErrorResult 系统错误

示例请求

请求path
1
POST /v1/org-user/202203201520/token
响应

HTTP 200 OK

1
2
3
4
{
  "token": "eyJraWQiOiJ1Ym1fc2RrX3VzZXIiLCJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzMDcyNDM2Mjk4ODkiLCJuYmYiOjE2NDYxMjAzNzEsImFwcGlkIjoiMTEwODU4ODQwIiwiaXNzIjoiaGFvY2hlemh1LmNsdWIiLCJjbGllbnQiOiIyMTAwMDAxIiwicmVhbG0iOiJvcGVuX2FwaSIsImV4cCI6MTY0NjcyNTQ3MSwiaWF0IjoxNjQ2MTIwNjcxLCJvcmdVc2VySWQiOiIyMDIyMDMwMTE1NDUifQ.DlnrkeyomaVYmzflH0CtO-k0OVpURv4VdFeIMKOe55BTjqxwQ832Ug0KouLSbJPEL0FogToNQaJNKmvKpDQWJkv24kxC8GnQfidvc3lKai4IO_j1_h4HvqS0HvM-Ir7NyQk59Ix9LSSRNikIQCufTnW1uFYTUc0l-KJBMGWwFWS2EJu2OGS10h-pFOozI8_7S9lCfKRCQ9ns9Zl2M9iQA9W9Xq1FvI7yOl0-2V4HlYh5dPPdfQtqQ-0_tAWCqd7AeSO1XIHc9YJk-vA9EsTXJcdMsbNmr4qktkEUet6qaPMjG2Zd4fh6eVfQ603R9xogS4A6vLXvtFmtaUrXXZrnnQ",
  "ubiUserId": 307243629889
}

获取凭证持有者用户信息

1
GET /v1/token/{token}

说明

获取 UBI passport token 持有者的基本信息。

参数

响应

HTTP 状态码 类型 说明
200 UserInfo 根据凭证获取凭证持有者信息
400 ErrorResult 请求参数不合法
500 ErrorResult 系统错误

示例

请求 path
1
GET /v1/token/token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
响应

HTTP 200 OK

1
2
3
4
{
  "ubiUserId": 307243629889,
  "orgUserId": "202203011545"
}

数据类型说明

SuccessResult

名称 类型 说明
token * string 为登录用户签发的passport token
ubiUserId * string UBI passport 为用户创建的唯一id

UserInfo

名称 类型 说明
ubiUserId * long 用户在 UBI passport 用户体系中的 User ID
orgUserId * string 用户在接入方的用户体系中的唯一标识