Postman & Ferramentas

Não há SDK oficial publicado ainda para a API Maestron — ela é consumida diretamente por HTTP, com qualquer cliente REST. Para começar rápido, use a collection Postman oficial, que já traz todos os endpoints documentados neste site.

Baixar a collection

Baixe o arquivo: maestron-api.postman_collection.json.
No Postman, Import → selecione o arquivo baixado.
Abra as variáveis da collection (ícone de engrenagem) e preencha api_key com o segredo da sua chave (ver Gerando sua API Key). Use uma chave de ambiente test para explorar sem gravar nada de verdade.
Preencha pipeline_id, stage_id, deal_id e activity_id conforme for criando os recursos, para reaproveitar nas próximas chamadas da collection.

Consumindo a API sem Postman

As regras aplicáveis a qualquer chamada, com qualquer cliente HTTP:

Base URL: https://api.maestron.com.br/api/v1.
Header Authorization: Bearer <segredo da chave> em toda requisição. Ver Autenticação.
Respostas seguem o envelope padrão (message + data); listagens incluem meta. Erros seguem Erros.

Exemplo com cURL — listar negócios:

curl -X GET "https://api.maestron.com.br/api/v1/crm/deals?per_page=20" \
  -H "Authorization: Bearer maestron_pk_test_SEU_SEGREDO"

Cada <Endpoint> desta documentação (por exemplo, em Negócios) já traz o exemplo equivalente em cURL, PHP, Python, Node.js, C# e HTTP cru — não é preciso reescrevê-los à mão.

Outros clientes REST

Insomnia

Importa a mesma collection Postman (formato v2.1) diretamente.

Bruno

Cliente open-source que guarda as requisições como arquivos versionáveis em Git; importa collections Postman.

HTTPie

Cliente de linha de comando para testes rápidos, com sintaxe enxuta para JSON e headers.

Para o fluxo mínimo de integração — do zero ao primeiro negócio criado — veja Primeiros passos.