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 geralmente seguem estas 5 etapas, desde o cadastro até a comunicação bem-sucedida com a primeira interface de negócio:- Obter o token da conta → Gerenciar tokens de 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ócio → Usar o Token de 32 caracteres obtido para chamar
https://api.acedata.cloud/<path>
Visão geral da interface
Explicação da 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 detalhes em Gerenciar tokens de conta da plataforma AceDataCloud.
⚠️ Os tokens de conta são tão sensíveis quanto senhas e não devem ser incluídos em código frontend ou repositórios públicos. Em caso de vazamento, exclua-os imediatamente no console e crie-os novamente.
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 encontrado (HTTP 404)
Serviço requer aprovação (HTTP 403)
need_verify=true (esse campo pode ser visto na lista de serviços), é necessário seguir o processo de ticket para solicitar inclusão na lista de permissões.
Tratamento de erros
Formato unificado de 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: ao solicitar,paid=false; após chamar Criar pedido de recarga da plataforma AceDataCloud e concluir o pagamento, torna-setrue. disabled=trueindica que foi temporariamente desativado — por exemplo, devido ao acionamento de controle de risco, inadimplência etc. Quando desativado, a interface de negócio retornará403.- Não crie com concorrência sem limites: primeiro obtenha o
service_idde destino a partir da lista paginada de serviços e, em seguida, solicite um por um conforme as necessidades de negócio; ao encontrarduplication, reutilize a Application existente.
Interfaces relacionadas
- Obter lista de serviços da plataforma AceDataCloud — selecione primeiro o serviço
- Obter lista de solicitações de serviços da plataforma AceDataCloud — visualizar todas as solicitações já realizadas
- Obter detalhes da solicitação de serviço da plataforma AceDataCloud — visualizar uma única solicitação
- Criar credencial de API da plataforma AceDataCloud — próximo passo após a solicitação ser bem-sucedida
- Criar pedido de recarga da plataforma AceDataCloud — recarregar após a cota gratuita ser esgotada
allow_overdraft vem desativado por padrão e é autorizado separadamente pelo administrador; ele não pode ser ativado por conta própria por meio de parâmetros da solicitação ao criar uma Application.
