跳到主要内容

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 / null企业账户名称
subdomain是String / null企业子域名(未配置时为 null)
users_count是Integer当前 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.*否BillingAccountUsageItem各项额度数据(见下)
feature_trial是Object特性试用状态
feature_trial.in_use是Boolean是否在试用中
feature_trial.expired是Boolean试用是否已过期
feature_trial.label是String / null试用套餐名称
feature_trial.end_date是String试用到期日(无试用时为空字符串)
merchant_accounts是Array(Object)已绑定的收款商户
merchant_accounts[].id是String收款商户 ID
merchant_accounts[].name是String / null商户名称
merchant_accounts[].merchant_no是String / null商户号
merchant_accounts[].channels是Array(String)已开通的支付渠道:wxpay / alipay
wxpay_accounts是Array(Object)已绑定的微信支付账户
wxpay_accounts[].id是String微信支付账户 ID
wxpay_accounts[].mch_id是String / null微信支付商户号
wxpay_accounts[].mch_name是String / null微信支付商户名称
alipay_accounts是Array(Object)已绑定的支付宝账户
alipay_accounts[].id是String支付宝账户 ID
alipay_accounts[].email是String / null支付宝账号邮箱
alipay_accounts[].account_type是String / null支付宝接口类型:create_direct_pay_by_user / create_partner_trade_by_buyer / trade_create_by_buyer / fast_instant_trade_pay

状态码​

状态码说明
200成功
401未认证
402当前套餐不支持 V1 API
403无权限(如 OAuth scope 不足)

数据类型​

BillingAccountUsageItem​

参数名称是否必须类型说明
unit是String计量单位:item / mb / second / cent
unlimited否Boolean额度不限时为 true,此时不返回额度与余额
total_quota否Integer本计费周期内的总额度
total_balance否Integer当前剩余总额度
month_balance否Integer当前剩余月度额度
consumed_quota是Integer已消耗额度

示例代码​

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)