Skip to main content
Uma “solicitação (Application)” representa a relação de assinatura da conta atual com determinado serviço — é necessário solicitar primeiro, para então criar credenciais de API para essa solicitação e chamar interfaces de negócios. Ao solicitar um serviço pela primeira vez, a Application receberá o 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:
  1. Obter o token da conta → Gerenciar token da conta da plataforma AceDataCloud
  2. Selecionar um serviço → Obter lista de serviços da plataforma AceDataCloud
  3. Criar uma solicitação (este documento) → obter a cota inicial conforme a configuração do serviço
  4. Criar credenciais de API → Criar credenciais de API da plataforma AceDataCloud
  5. 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:
O token da conta (Account Token) é a “chave em nível de conta” usada pelo desenvolvedor para gerenciar os recursos de sua própria conta por meio da API. Formas de obtenção:
  1. 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-.
  2. 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)

A estrutura dos campos retornados é consistente com Obter detalhes da solicitação de serviço da plataforma AceDataCloud.

Já solicitado (HTTP 400)

Esta é uma limitação rígida de design: cada usuário pode ter apenas uma Application para cada serviço. Caso já exista, encontre a existente por meio de Obter lista de solicitações de serviço da plataforma AceDataCloud.

Serviço não existe (HTTP 404)

Serviço requer revisão (HTTP 403)

Se o serviço tiver 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_amount atual 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 paid para 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-se true.
  • disabled=true significa 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_id de destino na lista paginada de serviços e, em seguida, solicite item por item conforme as necessidades do negócio; ao encontrar duplication, reutilize a Application existente.

Interfaces relacionadas