Início Rápido da API do Cliente: Integre a Accplanet /api/v2 em um Único Loop

Se você comprar na Accplanet programaticamente, não precisa de uma API diferente para cada ação. A Customer API usa um único endpoint — POST https://accplanet.com/api/v2 — e um parâmetro action. Este guia é um início rápido prático para que um desenvolvedor possa listar itens do catálogo, verificar estoque, fazer um pedido e consultar o status em uma única sessão.

Accplanet é um marketplace de agregação de fornecedores. Os fornecedores atendem o estoque; a Accplanet oferece descoberta, checkout, rastreamento de pedidos e suporte. Use a API apenas para gerenciamento legítimo de pedidos. Referência completa: Documentação da Customer API.

Autenticação e endpoint

Crie ou copie sua chave de API de cliente na página de chaves de API do seu perfil na Accplanet e então chame:

POST https://accplanet.com/api/v2

{
  "key": "SUA_CHAVE_DE_API",
  "action": "categories"
}

Ações suportadas: categories, shops, services, inventory, add, status, balance.

Etapas de integração

Pare quando cada etapa retornar uma resposta limpa antes de prosseguir.

Receitas curl prontas para copiar

# Saldo
curl -X POST https://accplanet.com/api/v2 -d "key=SUA_CHAVE_DE_API" -d "action=balance"

# Página de serviços
curl -X POST https://accplanet.com/api/v2 \
  -d "key=SUA_CHAVE_DE_API" -d "action=services" -d "page=1" -d "limit=50"

# Inventário
curl -X POST https://accplanet.com/api/v2 \
  -d "key=SUA_CHAVE_DE_API" -d "action=inventory" -d "service=10042"

# Adicionar pedido
curl -X POST https://accplanet.com/api/v2 \
  -d "key=SUA_CHAVE_DE_API" -d "action=add" -d "service=10042" -d "quantity=1"

# Status
curl -X POST https://accplanet.com/api/v2 \
  -d "key=SUA_CHAVE_DE_API" -d "action=status" -d "order=SEU_ID_DE_PEDIDO"

Substitua os placeholders pela sua chave, um service real de services e o order retornado por add. Comece com quantidade 1 em um item de teste de baixo custo.

Erros e limites de taxa

• Credenciais inválidas → HTTP 401 com {"error":"Invalid API key"}.
• Problemas de validação / estoque / saldo → geralmente HTTP 400 com uma única string error (ex.: estoque ou saldo insuficiente).
• Limite de taxa → HTTP 429 com Retry-After. Recue e tente novamente.
• O tamanho padrão da página de serviços é 50 ao paginar; use limit=0 apenas quando quiser intencionalmente a lista completa.

Preços, estoque e disponibilidade mudam com listagens ao vivo. Sempre releia services / inventory antes de compras automatizadas.

Checklist do comprador

• [ ] Chave da API armazenada em um gerenciador de segredos do servidor
• [ ] balance OK para um pequeno pedido de teste
• [ ] Escolhido um service com available=true
• [ ] Quantidade dentro de min/max
• [ ] ID de order de add persistido e status consultado
• [ ] Tratados 429 e erros de carteira no código

Próximo passo: abra a documentação da Customer API, execute o Test API uma vez e depois conecte as mesmas ações ao seu backend. Fornecedores que integram sincronização de catálogo devem ler o guia complementar para fornecedores no blog da Accplanet.

FAQ