跳到主要内容

v1 API 获取当前企业账户信息

API 使用者，可以通过本接口，查询当前凭证所属企业账户的套餐 / 月度用量 / 到期时间等信息。

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

认证方式​

V1 Bearer 认证方式

headers 设置​

需要在请求中设置如下 headers

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

接口说明​

  • 仅返回当前凭证所属的企业账户信息（无入参，天然只能查询自己）。
  • usage 字段包含本月度的核心额度消耗情况；当账户尚未生成本月用量记录时，该字段为 null。
  • feature_trial 反映特性试用状态（如企业版试用），非试用账户对应字段为 false / 空字符串。

接口描述​

Request​

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

无参数。

Response​

{
    "id": "69ae2a7f126da845e46e1139",
    "name": "示例企业",
    "subdomain": null,
    "users_count": 1,
    "plan": {
        "code": "e30",
        "name": "企业高级版",
        "end_date": "2027-03-09",
        "org_plan": true,
        "expired": false
    },
    "usage": {
        "next_reset_date": "2026-05-09",
        "sms": {
            "total_quota": 5000,
            "total_balance": 5000,
            "month_balance": 5000,
            "consumed_quota": 0
        },
        "active_mail": {
            "total_quota": 1500,
            "total_balance": 1500,
            "month_balance": 1500,
            "consumed_quota": 0
        },
        "entry_quota": {
            "total_quota": 500000,
            "total_balance": 499963,
            "month_balance": 499963,
            "consumed_quota": 37
        },
        "storage_quota": {
            "total_quota": 51200,
            "total_balance": 51200,
            "month_balance": 51200,
            "consumed_quota": 0
        }
    },
    "feature_trial": {
        "in_use": false,
        "expired": false,
        "label": "企业高级版",
        "end_date": ""
    }
}
参数名称是否必须类型说明
id是String企业账户 ID
name是String企业账户名称
subdomain否String企业子域名（未配置时为 null）
users_count是Number当前 active 成员数
plan是Object套餐信息（见下）
plan.code是String套餐代码（如 e10 / e20 / e30 / pro2 / free）
plan.name是String套餐展示名（中文）
plan.end_date是String套餐到期日期（YYYY-MM-DD）
plan.org_plan是Boolean是否企业套餐
plan.expired是Boolean企业套餐是否已过期
usage否Object | null本月度用量信息；账户未生成本月用量记录时为 null
usage.next_reset_date是String下次重置日（YYYY-MM-DD）
usage.sms / active_mail / entry_quota / storage_quota是Object各项额度数据（见下）
usage.{vas}.total_quota是Number本计费周期内的总额度
usage.{vas}.total_balance是Number当前剩余总额度
usage.{vas}.month_balance是Number当前剩余月度额度
usage.{vas}.consumed_quota是Number已消耗额度
feature_trial是Object特性试用状态
feature_trial.in_use是Boolean是否在试用中
feature_trial.expired是Boolean试用是否已过期
feature_trial.label否String当前生效套餐展示名
feature_trial.end_date否String试用到期日（无试用时为空字符串）

状态码​

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

示例代码​

HTTP​

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

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/billing_account',
    headers={'Authorization': f'Bearer {access_token}'}
)

print(response.text)

Ruby​

require 'net/http'
require 'uri'

uri = URI.parse('https://jinshuju.net/api/v1/billing_account')
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)