跳到主要内容

v1 API 获取当前用户信息

API 使用者,可以通过本接口,查询当前调用方的用户信息(id / 姓名 / 邮箱 / 手机号 / 角色 / 所属企业账户)。

功能免费版专业版/专业增强版企业基础版企业协作版企业高级版
获取当前用户信息✔️✔️✔️✔️✔️

认证方式​

V1 Bearer 认证方式

headers 设置​

需要在请求中设置如下 headers

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer YOUR_ACCESS_TOKEN

接口说明​

  • 用个人 / 子账号凭证调用,返回该用户信息。
  • 用企业全局 API 凭证(账户级 token)调用,返回该企业账户的 owner 信息。
  • 角色 role 取值:owner / admin / worker / outworker。

接口描述​

Request​

GET https://jinshuju.net/api/v1/me

无参数。

Response​

{
"id": "69ae2a7f126da845e46e1137",
"name": "张三",
"email": "zhangsan@example.com",
"mobile": "13812345678",
"role": "owner",
"billing_account_id": "69ae2a7f126da845e46e1139",
"created_at": "2026-03-09T02:03:43Z"
}
参数名称是否必须类型说明
id是String用户 ID
name是String用户显示名
email是String邮箱
mobile否String手机号(可能为空)
role是String在企业账户中的角色(owner / admin / worker / outworker)
billing_account_id是String所属企业账户 ID
created_at是DateTime用户创建时间(UTC)

状态码​

状态码说明
200成功
401未认证
402当前套餐不支持 V1 API

示例代码​

HTTP​

GET https://jinshuju.net/api/v1/me

Content-Type: application/json
Accept: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

Python​

import requests

access_token = 'YOUR_ACCESS_TOKEN'

response = requests.get(
'https://jinshuju.net/api/v1/me',
headers={'Authorization': f'Bearer {access_token}'}
)

print(response.text)

Ruby​

require 'net/http'
require 'uri'

uri = URI.parse('https://jinshuju.net/api/v1/me')
access_token = 'YOUR_ACCESS_TOKEN'

request = Net::HTTP::Get.new(uri)
request['Authorization'] = "Bearer #{access_token}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end

puts(response.body)