Início Rápido da API de Cliente Accplanet: Listar, Verificar Estoque e Fazer Pedidos

By Olivia Chen

Setembro 13, 2026 Buyer Tips 👁 160 Visualizações

Accplanet Customer API API key api design principles POST /api/v2 reseller API integration check stock API place order API Accplanet services API

Accplanet Customer API quick start

Get an API key and call POST /api/v2 to list services, check inventory, place an order, and poll status.

Create an API key
Open Profile → API key on Accplanet, generate a key, and store it in a secret environment variable.
List services and check stock
POST https://accplanet.com/api/v2 with action=services (cache results), then action=inventory for target service IDs.
Place order and poll status
POST action=add with service and quantity, then poll action=status with the returned order id. Honor HTTP 429 Retry-After.

Se você compra na Accplanet de forma programática, não precisa de uma URL diferente para cada ação. A Accplanet Customer API usa um único endpoint — POST https://accplanet.com/api/v2 — mais um parâmetro action. Este guia é um quick start prático para que um revendedor ou uma automação possa listar itens do catálogo, verificar estoque, fazer um pedido e consultar o status em uma única sessão.

A Accplanet é um marketplace de fornecedores. A Customer API é para compradores e revendedores que já possuem saldo. As tabelas completas de parâmetros estão na documentação da Customer API; este post foca no caminho funcional mais curto.

Resumindo

Crie uma API key no seu perfil da Accplanet e armazene-a como uma senha.
Chame POST https://accplanet.com/api/v2 com key + action (campos de formulário ou JSON).
Loop típico de revendedor: services → inventory → add → status (opcional balance).
Faça cache das leituras de catálogo. Trate HTTP 429 + Retry-After como backoff obrigatório, não como uma dica opcional.
Use este post para integrar rápido; use a documentação oficial para cada campo.

Obtenha sua API key

Faça login, abra Perfil → API key e gere uma API key. Copie-a uma vez para um gerenciador de segredos ou variável de ambiente (por exemplo, ACCPLANET_API_KEY). Toda chamada da Customer API se autentica com essa key no corpo como key (alias apikey).

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

Você também pode enviar campos codificados em formulário com curl -d. Prefira variáveis de ambiente a strings fixas no código.

Princípios de design da API (por que um único endpoint)

A Customer API da Accplanet segue alguns princípios de design de API práticos que simplificam a integração do revendedor:

Ponto de entrada único: uma URL, muitos valores de action — menos URLs base para configurar.
Autenticação explícita: a API key acompanha cada requisição; nenhum cookie de sessão opaco é necessário para scripts.
Vocabulário de ações: services, inventory, add, status, balance e ações relacionadas mapeiam claramente para catálogo → estoque → pedido → consulta.
Formato de erro estável: chamadas com falha retornam erros estruturados; limites de taxa usam HTTP 429.

É por isso que um cliente mínimo costuma ser um wrapper fino: definir a key, escolher a action, interpretar o JSON.

Escada de integração

1 · Teste rápido

Listar categorias

Confirme que a key funciona antes de montar a lógica de pedidos.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories"

2 · Catálogo

Obter services (produtos)

Use action=services para a API de services da Accplanet / sincronização de catálogo. Prefira um limit maior (até 500) e faça cache da resposta localmente por pelo menos 60–120 segundos. Esta é a action em que os revendedores atingem limites de taxa primeiro.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "limit=100"

3 · Estoque

Verificar inventory antes de add

Para um caminho de API de verificação de estoque, chame action=inventory com os IDs de service que lhe interessam. Evite chamadas add às cegas quando o estoque já estiver zerado no seu cache.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "services=10042"

4 · Pedido

Fazer o pedido, depois consultar o status

API de fazer pedido: action=add com service e, opcionalmente, quantity / link. Depois consulte com action=status e o id do pedido retornado. Não consulte o status a cada segundo.

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

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=ORDER_ID"

Limites de taxa que quebram as primeiras integrações

O tráfego autenticado da Customer API é limitado por cotas de burst, globais e por action. Regras práticas para integração de API de revendedor:

Faça cache de services; atualize em um agendamento (muitas vezes 2–5 minutos), não a cada visualização de página.
Um agendador por API key — evite três cron jobs sincronizando o mesmo catálogo.
Em HTTP 429, aguarde Retry-After segundos e tente novamente uma vez com backoff.

Os números exatos podem mudar; trate a documentação e as respostas 429 como fonte da verdade.

Checklist do comprador

API key armazenada em segredos, não no git.
Teste rápido de categories retorna dados.
Sincronização de catálogo usa services + cache local.
Pedidos usam inventory e depois add, depois consulta lenta de status.
Handler de 429 implementado antes do tráfego de produção.

FAQ

Corpo de formulário ou JSON?
Ambos funcionam para a Customer API v2. Use o que seu cliente HTTP en