Documentação para desenvolvedoresSDKs
SDKs do Once Email
SDKs candidatos de código aberto para a API somente de recebimento, testados em sete ecossistemas.
7 SDKs do Once Email
TypeScript, Python, Java, Go, .NET, PHP e Ruby usam um contrato OpenAPI revisado. Código, documentação, versões e arquivos são públicos.
TypeScript
npm ci && npm run buildpython -m pip install .mvn clean installgo mod edit -replace github.com/pangxin12345/once-email-sdks/sdks/go=./once-email-go-sdk-0.1.0-private.2dotnet build OnceEmail.Sdk.slncomposer installbundle install && gem build once_email.gemspecA CI nativa passou em Linux, macOS e Windows. TypeScript e Python executam testes; os demais passam build ou sintaxe nativa.
O proxy oficial de módulos Go ainda mantém o módulo preliminar anterior v0.1.0-private.1; o candidato Go atual é o arquivo versionado desta página. Não há versões formais em npm, PyPI, Maven Central, NuGet, Packagist ou RubyGems. Criação de API Key e chamadas reais seguem fechadas ao público. Confira SHA256SUMS do arquivo atual.
Use a linguagem do serviço de teste; os sete clientes seguem o mesmo contrato somente de recebimento.
Baixe um arquivo imutável, confira SHA256SUMS, leia o README incluído e fixe a versão.
Crie uma caixa por teste autorizado, limite o polling, separe 429/503, não registre mensagens ou códigos e exclua a caixa em finally.
Demo SDK
Baixe código, documentos e demo
Os arquivos versionados incluem código, documentação, limites e checksums.
Guia completa de uso
Escolher um SDK
Use somente aplicações próprias ou autorizadas. Once Email apenas recebe e-mail.
Verifique SHA256SUMS antes de extrair.
Ponto inicial local exato
Use o comando local do README do arquivo atual 0.1.0-private.2; o módulo antigo no Go Proxy é outra pré-versão.
Do download à limpeza
- Escolha a linguagem do serviço autorizado.
- Baixe o arquivo e verifique SHA-256.
- Confira versão, contrato, runtime, licença e status.
- Use o comando local do README do arquivo atual 0.1.0-private.2; o módulo antigo no Go Proxy é outra pré-versão.
- Prossiga somente com acesso à API explicitamente autorizado e credenciais válidas já emitidas com as permissões mínimas necessárias. Guarde-as em um mecanismo de segredos do processo; sem esse acesso, limite-se a revisar a documentação e os downloads. Injete a chave como segredo e execute dentro de um prazo.
- Exclua em finally e não imprima dados sensíveis.
Falhas e recuperação
Separe 400/401/403/404/413/429/503, timeout, ambiguidade, extração, asserção e limpeza. Tente novamente apenas dentro do prazo.