SDK (Software Development Kit)

Um SDK (Software Development Kit) é um pacote pronto a usar de bibliotecas de código, ferramentas e documentação que transforma uma API em funções para uma linguagem de programação. Em vez de escrever pedidos HTTP manualmente, os programadores chamam funções já prontas.

O que é um SDK?

Um SDK (Software Development Kit) é um pacote pronto a usar de bibliotecas de código, ferramentas e documentação para uma linguagem de programação. Transforma uma API em funções que os programadores chamam diretamente. Em vez de construir pedidos HTTP manualmente, ler respostas JSON e tratar os erros por conta própria, basta uma linha como client.messages.send(). O SDK trata do resto.

Existem duas variantes. Um SDK leve reproduz os endpoints da API um a um e acrescenta sobretudo tipos. Um SDK completo acrescenta comodidade, como novas tentativas automáticas, paginação ou a verificação de assinaturas de webhooks. Cada SDK está ligado a uma única linguagem: um fornecedor que queira servir programadores de Python, JavaScript e PHP tem de criar e manter três pacotes separados.

SDK ou REST API direta?

Um SDK é sempre uma camada por cima de uma API, normalmente uma REST API. Os dois caminhos levam ao mesmo resultado. A diferença está no esforço:

Com SDK: primeiros passos mais rápidos, funções tipadas e menos erros no código. Em troca, depende de o fornecedor manter o pacote atualizado para a sua linguagem e versão.
Diretamente por REST: funciona em qualquer linguagem que consiga enviar pedidos HTTP, sem pacotes adicionais. Vê exatamente o que é transmitido, mas escreve a autenticação, o tratamento de erros e as novas tentativas por conta própria.

Para a maioria das integrações de mensagens bastam algumas chamadas REST diretas: autenticar, enviar uma mensagem, receber atualizações de estado. Por isso, muitas equipas dispensam os SDK ou geram o seu próprio cliente a partir da descrição da API.

O seu próprio cliente a partir de uma especificação OpenAPI

Muitas API publicam uma especificação OpenAPI: um ficheiro legível por máquina que descreve cada endpoint, cada parâmetro e cada resposta. A partir deste ficheiro obtém grande parte do que um SDK oferece, sem esperar por um pacote oficial:

Gerar código cliente: ferramentas como o OpenAPI Generator criam a partir da especificação um cliente tipado para a sua linguagem.
Testar em ferramentas de API: o Postman, o Insomnia ou o Bruno importam a especificação, para experimentar cada endpoint antes de escrever código.
Usar ferramentas de programação com IA: assistentes como o Claude Code, o Cursor ou o GitHub Copilot leem a especificação e a documentação e escrevem o código de integração para a sua stack.

SDK na SendSeven

A SendSeven não oferece SDK por linguagem para a sua REST API. O único SDK é o SDK de push: um pequeno trecho de código que acrescenta notificações push no navegador ao seu próprio site. Para tudo o resto, liga-se diretamente à REST API, com estas ajudas:

Especificação OpenAPI: gerar código cliente ou importá-la no Insomnia ou no Bruno.
Coleção Postman: pedidos já prontos para experimentar os endpoints.
Documentação para ferramentas de programação com IA: cada página de docs.sendseven.com está também disponível em Markdown, com um prompt pronto para o Claude Code, o Cursor e o GitHub Copilot.
Servidor MCP: agentes de IA como o Claude trabalham diretamente com a SendSeven.
Sem código: o Zapier, o Make e o n8n ligam a SendSeven a outras ferramentas sem programação.

A autenticação é feita com uma chave de API, enviada como token Bearer. As instruções passo a passo estão no guia de autenticação da API e todos os endpoints na documentação para programadores.