Saltar para o conteúdo principal
Uma «solicitação (Application)» representa a relação de assinatura da conta atual com um determinado serviço — é necessário primeiro solicitar para então criar credenciais de API para essa solicitação e chamar interfaces de negócio. 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 geralmente seguem estas 5 etapas, desde o cadastro até a comunicação bem-sucedida com a primeira interface de negócio:
  1. Obter o token da conta → Gerenciar tokens de 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ó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:
O token da conta (Account Token) é uma «chave de nível de conta» usada pelos desenvolvedores para gerenciar os recursos de suas próprias contas por meio da API. Formas de obtê-lo:
  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 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)

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 do projeto: cada usuário pode ter apenas uma Application para cada serviço. Se já existir, encontre a solicitação existente por meio de Obter lista de solicitações de serviço da plataforma AceDataCloud.

Serviço não encontrado (HTTP 404)

Serviço requer aprovação (HTTP 403)

Se o serviço tiver 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_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: ao solicitar, paid=false; após chamar Criar pedido de recarga da plataforma AceDataCloud e concluir o pagamento, torna-se true.
  • disabled=true indica 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_id de destino a partir da lista paginada de serviços e, em seguida, solicite um por um conforme as necessidades de negócio; ao encontrar duplication, reutilize a Application existente.

Interfaces relacionadas

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.