开发者内部 UserID登录

POST

/v2/user/login/user-id

开发者拥有自己的帐号体系时，传入用户的userId（开发者保证唯一性），可获得此用户在探鸽TIVS平台的登陆态access_token。TIVS平台将自动根据唯一ID创建开发者用户和探鸽平台内部用户的一一映射关系。
限开发者服务器调用，禁止在客户端调用，会启用服务器白名单检测。

注意：整个TIVS平台，仅有此接口user_id参数是开发者自己系统内的用户ID，此外未做特殊说明时，user_id参数均是TIVS平台的用户ID

详细说明文档及DEMO代码示例：https://tange-ai.feishu.cn/wiki/wikcn6GaETEIVO0jgCP1ASHf3Mg

请求参数

Header 参数

Body 参数application/json

示例

{"user_id": "0"}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/user/login/user-id' \
--header 'X-Tg-Signed-Headers: content-length;content-type;x-tg-app-id;x-tg-date' \
--header 'X-Tg-App-Id: xxx' \
--header 'X-Tg-Date: {{currentUTCTime}}' \
--header 'X-Tg-Algorithm: TGV1-HMAC-SHA256' \
--header 'X-Tg-Content-Sha256;' \
--header 'Accept-Language: zh-CN' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{"user_id": "0"}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "access_token": "eyJhbGc1iOiJFZERTQSIsImtpZCI6Im8xWnkzWE5TSGhxOCIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1NjQxNTQzIiwiaXNzIjoiYXBwL2xvZ2luIiwiaWF0IjoxNjg5Njg1NTQxLCJleHAiOjE3MDQyMDA3NDEsImF1ZCI6WyJhcHAvYmFja21VuZCJdLCJnaWQiOiJxbXN5IiwidWlkIjo1NjQxNTQzLCJsYW5nIjoiemgtY24ifQ.SIHouY5-C0W3BdIgPUZqW_liDhaZ1bvrt3XYDU_-LvtsrTAQpQy-J36Op_WZ3AxIBQoOgBfLCIvdJ30hhpUu1Bg",
        "expires_in": 7200,
        "user_id": 1024,
        "refresh_token": "eyJhbGc1iOiJFZERTQSIsImtpZCI6Im8xWnkzWE5TSGhxOCIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1NjQxNTQzIiwiaXNzIjoiYXBwL2xvZ2luIiwiaWF0IjoxNjg5Njg1NTQxLCJleHAiOjE3MDQyMDA3NDEsImF1ZCI6WyJhcHAvYmFja21VuZCJdLCJnaWQiOiJxbXN5IiwidWlkIjo1NjQxNTQzLCJsYW5nIjoiemgtY24ifQ.SIHouY5-C0W3BdIgPUZqW_liDhaZ1bvrt3XYDU_-LvtsrTAQpQy-J36Op_WZ3AxIBQoOgBfLCIvdJ30hhpUu1Bg"
    }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误

修改于 2026-01-15 02:47:55

注销账号