Clientes HTTP por linguagem

As fontes oficiais consultadas documentam APIs HTTP e exemplos de requisição, mas não confirmam pacotes SDK oficiais para Node.js, PHP ou Python. Use o cliente HTTP da sua linguagem respeitando o contrato de cada produto.

JavaScript

Um cliente pequeno pode receber a URL base e o token Bearer sem acoplar sua aplicação a um produto:

async function apiGet(baseUrl, caminho, token) {
  const resposta = await fetch(new URL(caminho, baseUrl), {
    headers: {
      Authorization: `Bearer ${token}`,
      Accept: "application/json",
    },
  });

  if (!resposta.ok) {
    throw new Error(`API respondeu ${resposta.status}`);
  }
  return resposta.json();
}

const filial = await apiGet(
  "https://www.allpost.com.br/api/v1/",
  "filial",
  process.env.ALLPOST_TOKEN
);

PHP

<?php
function apiGet(string $url, string $token): array {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $token,
            'Accept: application/json',
        ],
    ]);

    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($status < 200 || $status >= 300) {
        throw new RuntimeException("API respondeu {$status}");
    }
    return json_decode($body, true, flags: JSON_THROW_ON_ERROR);
}

Python

Para o Portal do Seller, use Basic Auth com senha vazia e o cabeçalho de integração:

import os
import requests

session = requests.Session()
session.auth = (os.environ["PDS_TOKEN"], "")
session.headers.update({
    "grand_type": "integrate",
    "Accept": "application/json",
})

response = session.get(
    "https://api.portaldoseller.com.br/v2/products",
    params={"page": 1, "size": 20},
    timeout=30,
)
response.raise_for_status()

Configuração por produto

ALLPOST_BASE_URL=https://www.allpost.com.br/api/v1/
SELLERPAY_BASE_URL=https://www.sellerpay.com.br/api/v1/
HELPYGO_BASE_URL=https://www.helpygo.com.br/api/v1/
PDS_BASE_URL=https://api.portaldoseller.com.br/v2/
PRECODE_BASE_URL=https://www.replicade.com.br/api/v1/

Resiliência

• Defina timeout em todas as requisições.
• Respeite a cota publicada no endpoint e o cabeçalho Retry-After.
• Repita automaticamente apenas operações seguras ou idempotentes.
• Registre status, rota e identificador da operação sem gravar credenciais.
• Valide o corpo real de cada endpoint na documentação oficial.

Próximos passos

Consulte os exemplos confirmados ou use o MCP oficial dos produtos que o disponibilizam.