使用 codex2 身份登录开放平台

POST

/v1/portal/external-login

接收 codex2 在手机号或微信登录后签发的一次性身份断言，建立 30 分钟 Portal 会话。身份断言只能使用一次。

请求参数

Body 参数application/json必填

示例

{
    "assertion": "eyJhbGciOiJIUzI1NiIsImtpZCI6ImNvZGV4Mi12MSJ9.example.signature"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/portal/external-login' \
--header 'Content-Type: application/json' \
--data '{
    "assertion": "eyJhbGciOiJIUzI1NiIsImtpZCI6ImNvZGV4Mi12MSJ9.example.signature"
}'

返回响应

🟢200

application/json

登录成功，返回仅供开放平台页面使用的短期会话令牌。

Bodyapplication/json

示例

{
    "accessToken": "ys_portal_example",
    "expiresAt": "2026-09-28T09:30:00.000Z",
    "user": {
        "id": "user_example",
        "displayName": "张三"
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠409Conflict

🔴500InternalError

修改于 2026-09-28 10:26:20

数字员工接入指南

查看开放平台当前用户