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

Documentación para desarrolladores

Documentación para desarrolladores SDK

# SDK de Once Email

SDK candidatos de código abierto para la API de recepción de Once Email, probados en siete ecosistemas.

[Ver código](<https://github.com/pangxin12345/once-email-sdks>) [SHA256SUMS](<https://once-email.com/downloads/sdk/SHA256SUMS>) [Leer el contrato API](<https://once-email.com/es/api>) [Leer la guía de pruebas con SDK](<https://once-email.com/es/blog/temporary-email-api-testing-guide>)

## [7 SDK de Once Email](<https://once-email.com/es/sdk#languages>)

TypeScript, Python, Java, Go, .NET, PHP y Ruby comparten un contrato OpenAPI revisado. El código, la documentación, las versiones y los archivos son públicos.

### TypeScript

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

[Descargar versión preliminar](<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

La CI nativa pasó en Linux, macOS y Windows. TypeScript y Python ejecutan pruebas; los demás pasan compilación o sintaxis nativa.

Estado de publicación

Son candidatos públicos, todavía no publicados en los registros de cada lenguaje. Fija la versión y verifica SHA256SUMS.

Cada archivo incluye código y documentación, además de MANIFEST.txt y SHA256SUMS.

Elegir un SDK

Usa el lenguaje de tu servicio de pruebas; los siete clientes comparten el mismo contrato de solo recepción.

Verificar antes de instalar

Descarga un archivo versionado, compáralo con SHA256SUMS, lee su README y fija la versión.

Limitar el flujo

Crea un buzón por prueba autorizada, limita el sondeo, separa 429/503, no registres mensajes ni códigos y elimina el buzón en finally.

Demo SDK

## Descarga código, documentos y demo

Los archivos versionados incluyen código, documentación, límites y sumas.

[Descarga 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>)

Guía de uso completa

## Elegir un SDK

Úsalo solo con aplicaciones propias o autorizadas. Once Email solo recibe correo.

Documentación y código públicos; API controlada y descargas preliminares fuera de registros. La documentación pública y las descargas preliminares no conceden acceso a la API. La creación de claves API y las llamadas reales no están abiertas al público.

Verifica SHA256SUMS antes de extraer.

[Elegir un SDK](<https://once-email.com/es/sdk#languages>) [SHA256SUMS](<https://once-email.com/downloads/sdk/SHA256SUMS>)

Punto de inicio local exacto

Usa el comando local exacto del README; no hay instalación desde registry.

## De la descarga a la limpieza

1. Elige el lenguaje del servicio autorizado.
2. Descarga su archivo y verifica SHA-256.
3. Comprueba versión, contrato, runtime, licencia y estado.
4. Usa el comando local exacto del README; no hay instalación desde registry.
5. Continúa solo con acceso a la API expresamente autorizado y credenciales válidas ya emitidas con los permisos mínimos necesarios. Guárdalas en un mecanismo de secretos del proceso; sin ese acceso, limítate a revisar documentación y descargas. Inyecta la clave como secreto y ejecuta el flujo dentro de un plazo.
6. Elimina en finally y no imprimas datos sensibles.

## Errores y recuperación

Distingue 400/401/403/404/413/429/503, tiempo agotado, ambigüedad, extracción, aserción y limpieza. Reintenta solo dentro de un plazo.

[Ver código público](<https://github.com/pangxin12345/once-email-sdks>) [Leer guía práctica](<https://once-email.com/es/blog/temporary-email-api-testing-guide>)