AceDataCloud平台剩余额度查询

admin 2026-06-26 09:16:30 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

文章总结: 本文档详细介绍了AceDataCloud平台查询API剩余额度的完整流程,包括获取申请ID、创建永久有效的账户令牌,以及通过GET请求查询剩余额度的具体API接口格式。文档提供了curl命令示例及Python、Node.js、Java、PHP等多种编程语言的实现代码,并说明响应结果中remaining_amount字段即为剩余额度值。 综合评分: 78 文章分类: 技术标准,解决方案


cover_image

Ace Data Cloud 平台剩余额度查询

进击的Coder

2026年6月23日 23:54 江苏

在小说阅读器读本章

去阅读

由于 Ace Data Cloud 平台的大多数 API 都是按额度收费的,因此在对接 API 后,为了防止 API 额度突然耗尽而给贵平台造成业务中断或损失,Ace Data Cloud 平台开放了接口用于查询剩余额度。通过这一接口,贵平台可以在检测到额度不足时及时进行充值,确保业务的连续性。

本文档将介绍如何对接查询剩余额度的接口。

查看申请 ID

首先,需要了解 Ace Data Cloud 平台的每个 API 服务都对应一个“申请”实例。每个“申请”实例都有自己的 ID、密钥、剩余额度等信息,您可以在 https://platform.acedata.cloud/console/applications ,或者识别下方二维码:

然后查看您所有的申请列表。

接下来,如果要查询某个申请的剩余额度,需要将对应的申请 ID 复制下来。

例如,假设您想查询“Midjourney API”的剩余额度,您可以将该 ID 复制并记录为application_id

创建账户令牌

Ace Data Cloud 平台提供了「账户令牌」(旧称「平台令牌」)机制,方便开发者通过 API 查询 Ace Data Cloud 账户信息,如订单列表、申请列表、分销信息、调用记录等。这其中自然也包括查询剩余额度的功能。该令牌的功能类似于登录 Ace Data Cloud 平台后的用户 token,登录后可以基于它查看账户下的申请列表、订单列表、调用记录等信息。但与用户 token 不同的是,账户令牌的有效期是永久的,而用户 token 则会在一段时间后失效(失效后需要重新登录)。

因此,通过账户令牌,您可以方便地获取 Ace Data Cloud 平台的账户信息。

首先,您需要在 https://platform.acedata.cloud/console/platform-tokens 创建一个账户令牌,如图所示:

复制该「账户令牌」,并记录为token

额度查询

有了上述的application_idtoken后,您就可以构造 URL 来查询剩余额度了。额度查询的 API 格式如下:

  • 请求方式:GET

  • 请求 URL:https://platform.acedata.cloud/api/v1/applications/{application_id}

  • 请求 Headers:

  • accept: application/json

  • authorization: Bearer {token}

CURL 请求代码如下:

curl -X GET \
  -H "accept: application/json" \
  -H "authorization: Bearer {token}" \
  "https://platform.acedata.cloud/api/v1/applications/{application_id}"

如 token 为 platform-v1-5b8fbef60bc547098034db3e9f36a623731c490abe854f72972a0a3473b4c56bapplication_id 为 107f8d0f-e465-4a7e-a49e-d633d26f7aa2,那么命令如下:

curl -X GET \
  -H "accept: application/json" \
  -H "authorization: Bearer platform-v1-5b8fbef60bc547098034db3e9f36a623731c490abe854f72972a0a3473b4c56b" \
  "https://platform.acedata.cloud/api/v1/applications/107f8d0f-e465-4a7e-a49e-d633d26f7aa2"

请将{application_id}替换为实际的应用程序 ID,并将{token}替换为有效的账户令牌。

该 CURL 命令将发送 GET 请求到指定的 URL,并在请求头中包含所需的acceptauthorization信息。

示例结果如下:

{
  "id": "107f8d0f-e465-4a7e-a49e-d633d26f7aa2",
  "service_id": "d87e5e99-b797-4ade-9e73-b896896b0461",
  "remaining_amount": 493.2210000000001,
  "used_amount": 21.778999999999996,
  "service": {
    ...
  },
  "user_id": "b87f67c1-b04f-4332-99a1-7a5e651331c6",
  "created_at": "2024-05-30T14:41:20.052849Z",
  "updated_at": "2024-08-16T07:51:15.603207Z",
  "tags": null,
  "expired_at": null,
  "type": "Usage",
  "metadata": null
}

其中,JSON 结果的remaining_amount即为剩余额度。

对于其他编程语言,只需将 CURL 命令改写为相应的语言格式即可。如果在改写时遇到困难,可以使用https://curlconverter.com/工具将 CURL 命令转换为其他语言。

如 Python 语言:

import requests

url = "https://platform.acedata.cloud/api/v1/applications/{application_id}"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}"
}

response = requests.get(url, headers=headers)
print(response.json())

如 Node.js 语言:

import axios from "axios";

const url =
  "https://platform.acedata.cloud/api/v1/applications/{application_id}";
const headers = {
  accept: "application/json",
  authorization: "Bearer {token}",
};

axios
  .get(url, { headers })
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error);
  });

如 Java 语言:

import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        String url = "https://platform.acedata.cloud/api/v1/applications/{application_id}";
        String token = "{token}";

        Request request = new Request.Builder()
                .url(url)
                .addHeader("accept", "application/json")
                .addHeader("authorization", "Bearer " + token)
                .build();

        try {
            Response response = client.newCall(request).execute();
            String responseData = response.body().string();
            System.out.println(responseData);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

如 PHP 语言:

<?php

$url =&nbsp;'https://platform.acedata.cloud/api/v1/applications/{application_id}';
$token =&nbsp;'{token}';

$headers =&nbsp;array(
&nbsp; &nbsp;&nbsp;'accept: application/json',
&nbsp; &nbsp;&nbsp;'authorization: Bearer '&nbsp;. $token
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,&nbsp;true);

$response = curl_exec($ch);

curl_close($ch);

echo&nbsp;$response;
?>

免责声明:

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景,旨在提升网络安全防护能力,具有明确的技术研究属性。

任何单位或个人未经授权,将本文内容用于攻击、破坏等非法用途的,由此引发的全部法律责任、民事赔偿及连带责任,均由行为人独立承担,本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布,若存在版权侵权或其他异议,请通过邮件联系处理,具体联系方式可点击页面上方的联系我

本文转载自:进击的Coder 《Ace Data Cloud 平台剩余额度查询》

评论:0   参与:  0