Documentación para desarrolladoresSDK
SDK de Once Email
SDK candidatos de código abierto para la API de recepción de Once Email, probados en siete ecosistemas.
7 SDK de Once Email
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
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.gemspecLa CI nativa pasó en Linux, macOS y Windows. TypeScript y Python ejecutan pruebas; los demás pasan compilación o sintaxis nativa.
El proxy oficial de módulos Go aún conserva el módulo preliminar anterior v0.1.0-private.1; el candidato Go actual es el archivo versionado de esta página. No hay versiones formales en npm, PyPI, Maven Central, NuGet, Packagist ni RubyGems. Crear API Key y hacer llamadas reales sigue cerrado al público. Verifica SHA256SUMS del archivo actual.
Usa el lenguaje de tu servicio de pruebas; los siete clientes comparten el mismo contrato de solo recepción.
Descarga un archivo versionado, compáralo con SHA256SUMS, lee su README y fija la versión.
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.
Guía de uso completa
Elegir un SDK
Úsalo solo con aplicaciones propias o autorizadas. Once Email solo recibe correo.
Verifica SHA256SUMS antes de extraer.
Punto de inicio local exacto
Usa el comando local del README del archivo actual 0.1.0-private.2; el módulo anterior de Go Proxy es otra versión preliminar.
De la descarga a la limpieza
- Elige el lenguaje del servicio autorizado.
- Descarga su archivo y verifica SHA-256.
- Comprueba versión, contrato, runtime, licencia y estado.
- Usa el comando local del README del archivo actual 0.1.0-private.2; el módulo anterior de Go Proxy es otra versión preliminar.
- 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.
- 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.