创建 AceDataCloud 平台服务申请

创建 AceDataCloud 平台服务申请

💡 原文中文,约4500字,阅读约需11分钟。
📝

内容提要

本文介绍AceDataCloud平台创建服务申请的API教程。申请表示账户对服务的订阅关系,首次申请自动获得免费额度。完整流程为:获取账户令牌、挑选服务、创建申请、创建API凭证、调用业务接口。接口为POST https://platform.acedata.cloud/api/v1/applications/,需Bearer令牌鉴权,请求体含service_id。成功返回201及申请详情,重复申请返回400,服务不存在返回404,需审核返回403。申请免费,付费状态看paid字段。

🔎

延伸解读

申请是订阅关系,不是直接开通

在AceDataCloud中,申请(Application)代表账户对服务的订阅关系,必须先申请才能创建API凭证并调用业务接口。首次申请会自动获得免费额度(如1 Credit),可立即试用。注意,每个用户对每个服务只能有一个申请,重复申请会返回400错误,需通过申请列表查找现有申请。

注意错误码与审核机制

接口返回的错误码有明确含义:400表示重复申请或service_id无效,401表示令牌问题,403表示服务需要人工审核(need_verify=true),404表示服务不存在。若服务需要审核,需走工单流程申请白名单。建议在代码中处理这些状态码,以便用户了解具体问题。

免费额度与付费状态

创建申请是免费操作,仅赠送一次性免费额度,不会扣余额。免费额度用完后调用业务接口才会失败,提示充值。申请时paid字段为false,完成支付后变为true。若disabled为true,表示申请被暂时禁用(如风控或欠费),业务接口会返回403。

Q&A

如何在AceDataCloud平台上创建服务申请?

调用POST https://platform.acedata.cloud/api/v1/applications/接口,在请求头中携带Bearer令牌(账户令牌),请求体包含service_id(服务ID)。成功返回201及申请详情。

AceDataCloud平台的服务申请是什么?

服务申请(Application)表示当前账户对某个服务的订阅关系。必须先申请服务,才能为该申请创建API凭证并调用业务接口。首次申请会自动获得该服务设定的免费额度(如1 Credit)。

AceDataCloud平台创建服务申请需要哪些参数?

需要账户令牌(Account Token)和服务ID(service_id)。账户令牌通过控制台创建或API获取,服务ID从服务列表的items[].id获取。请求体只需service_id字段。

AceDataCloud平台创建服务申请可能返回哪些错误?

可能返回400(重复申请或service_id无效)、401(未认证)、403(服务需要审核)、404(服务不存在)。错误响应包含detail、code和trace_id字段。

AceDataCloud平台创建服务申请是否收费?

申请是免费操作,仅在创建时赠送一次性免费额度,不会扣余额。免费额度用完后调用业务接口会失败,需要充值。付费状态可通过paid字段查看。

AceDataCloud平台创建服务申请后如何获取免费额度?

首次申请一个服务会自动获得该服务设定的免费额度(如1 Credit),可立即试用。免费额度在申请成功后自动发放,无需额外操作。

AceDataCloud平台创建服务申请时如何获取账户令牌?

账户令牌可通过两种方式获取:1)控制台一键创建:登录平台,在Account Token控制台点击“创建”即可获得platform-v1-开头的令牌;2)API创建:调用POST /api/v1/platform-tokens/,使用已有令牌或浏览器登录态JWT。

AceDataCloud平台创建服务申请时如何处理重复申请?

如果重复申请同一服务,接口会返回400错误,code为duplication。此时应通过获取服务申请列表找到现成的application_id,而不是重复创建。

🏷️

标签

➡️

继续阅读