Source: https://once-email.com/pt/sdk

Documentação para desenvolvedores

Documentação para desenvolvedores SDKs

# SDKs do Once Email

SDKs candidatos de código aberto para a API somente de recebimento, testados em sete ecossistemas.

[Ver código](<https://github.com/pangxin12345/once-email-sdks>) [SHA256SUMS](<https://once-email.com/downloads/sdk/SHA256SUMS>) [Ler o contrato da API](<https://once-email.com/pt/api>) [Ler o guia de testes com SDK](<https://once-email.com/pt/blog/temporary-email-api-testing-guide>)

## [7 SDKs do Once Email](<https://once-email.com/pt/sdk#languages>)

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

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-typescript-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/typescript>)

```
npm ci && npm run build
```

### Python

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-python-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/python>)

```
python -m pip install .
```

### Java

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-java-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/java>)

```
mvn clean install
```

### Go

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-go-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/go>)

```
go mod edit -replace github.com/pangxin12345/once-email-sdks/sdks/go=./once-email-go-sdk-0.1.0-private.2
```

### .NET

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-dotnet-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/dotnet>)

```
dotnet build OnceEmail.Sdk.sln
```

### PHP

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-php-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/php>)

```
composer install
```

### Ruby

[Baixar pré-lançamento](<https://once-email.com/downloads/sdk/once-email-ruby-sdk-0.1.0-private.2.zip>) [Ver código](<https://github.com/pangxin12345/once-email-sdks/tree/main/sdks/ruby>)

```
bundle install && gem build once_email.gemspec
```

Linux · macOS · Windows

A CI nativa passou em Linux, macOS e Windows. TypeScript e Python executam testes; os demais passam build ou sintaxe nativa.

Status da versão

São candidatos públicos, ainda não publicados nos registros das linguagens. Fixe a versão e verifique SHA256SUMS.

Cada arquivo contém código e documentação, além de MANIFEST.txt e SHA256SUMS.

Escolher um SDK

Use a linguagem do serviço de teste; os sete clientes seguem o mesmo contrato somente de recebimento.

Verificar antes de instalar

Baixe um arquivo imutável, confira SHA256SUMS, leia o README incluído e fixe a versão.

Limitar o fluxo

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.

[Download local](<https://once-email.com/downloads/once-email-developer-demo-0.1.0-private.2.zip>) [Ver demos](<https://github.com/pangxin12345/once-email-sdks/tree/main/demos>)

Guia completa de uso

## Escolher um SDK

Use somente aplicações próprias ou autorizadas. Once Email apenas recebe e-mail.

Documentação e código públicos; API controlada e downloads preliminares fora dos registros. Documentação pública e downloads preliminares não concedem acesso à API. A criação de chaves API e as chamadas reais não estão abertas ao público.

Verifique SHA256SUMS antes de extrair.

[Escolher um SDK](<https://once-email.com/pt/sdk#languages>) [SHA256SUMS](<https://once-email.com/downloads/sdk/SHA256SUMS>)

Ponto inicial local exato

Use o comando local do README; não há instalação por registry.

## Do download à limpeza

1. Escolha a linguagem do serviço autorizado.
2. Baixe o arquivo e verifique SHA-256.
3. Confira versão, contrato, runtime, licença e status.
4. Use o comando local do README; não há instalação por registry.
5. 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.
6. 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.

[Ver código público](<https://github.com/pangxin12345/once-email-sdks>) [Ler guia prático](<https://once-email.com/pt/blog/temporary-email-api-testing-guide>)