free_amount atualmente configurado para esse serviço; esse valor pode ser 0.
ℹ️ Esta interface pertence à API de gerenciamento da plataforma AceDataCloud, com o prefixo unificado https://platform.acedata.cloud/api/v1/. Para o índice completo de interfaces, consulte Obter lista de documentos da plataforma AceDataCloud.
Fluxo completo de integração
Novos usuários normalmente seguem estas 5 etapas, desde o registro até a chamada da primeira interface de negócios:- Obter o token da conta → Gerenciar token da conta da plataforma AceDataCloud
- Selecionar um serviço → Obter lista de serviços da plataforma AceDataCloud
- Criar uma solicitação (este documento) → obter a cota inicial conforme a configuração do serviço
- Criar credenciais de API → Criar credenciais de API da plataforma AceDataCloud
- Chamar a interface de negócios → usar o Token de 32 caracteres obtido para chamar
https://api.acedata.cloud/<path>
Visão geral da interface
Instruções de autenticação (como obter o token da conta)
Cabeçalho da solicitação:- Criação com um clique no console (recomendado): faça login na plataforma AceDataCloud → console de Account Token → clique em “Criar” para obter um token que começa com
platform-v1-. - Criação por API: use um token de conta existente ou o JWT da sessão de login do navegador para chamar
POST /api/v1/platform-tokens/; consulte Gerenciar token da conta da plataforma AceDataCloud para detalhes.
⚠️ O token da conta é tão sensível quanto uma senha e não deve ser incluído em código de frontend ou repositórios públicos. Caso seja vazado, exclua-o imediatamente no console e crie um novo.
Corpo da solicitação
Exemplos de solicitação
cURL
Python
Node.js
Exemplo de resposta
Sucesso (HTTP 201)
Já solicitado (HTTP 400)
Serviço não existe (HTTP 404)
Serviço requer revisão (HTTP 403)
need_verify=true (esse campo pode ser visto na lista de serviços), será necessário seguir o processo de ticket para solicitar inclusão na lista de permissões.
Tratamento de erros
Formato unificado da resposta de erro:
Dicas práticas
- A criação em si não gera cobrança: na primeira criação, a cota inicial é definida de acordo com o
free_amountatual do serviço; esse valor pode ser 0, e criar novamente uma Application do mesmo tipo não garante a concessão repetida. - Verifique o campo
paidpara saber se é necessário pagar: logo após a solicitação,paid=false; após chamar Criar pedido de recarga da plataforma AceDataCloud para concluir o pagamento, torna-setrue. disabled=truesignifica que foi temporariamente desativado — por exemplo, devido ao acionamento de controle de risco, inadimplência etc. Quando desativado, a interface de negócios retornará403.- Não crie com concorrência ilimitada: primeiro obtenha o
service_idde destino na lista paginada de serviços e, em seguida, solicite item por item conforme as necessidades do negócio; ao encontrarduplication, reutilize a Application existente.
Interfaces relacionadas
- Obter lista de serviços da plataforma AceDataCloud — primeiro escolha o serviço
- Obter lista de solicitações de serviços da plataforma AceDataCloud — visualizar todos os já solicitados
- Obter detalhes da solicitação de serviço da plataforma AceDataCloud — visualizar uma única solicitação
- Criar credencial de API da plataforma AceDataCloud — próxima etapa após a solicitação ser bem-sucedida
- Criar pedido de recarga da plataforma AceDataCloud — recarregar após a cota gratuita se esgotar

