개발자 문서SDK
Once Email SDK
수신 전용 API용 오픈 소스 SDK 후보를 7개 생태계에서 테스트했습니다.
7 Once Email SDK
TypeScript, Python, Java, Go, .NET, PHP, Ruby가 검토된 OpenAPI 계약을 공유합니다. 소스, 문서, 버전과 압축 파일을 공개합니다.
TypeScript
npm ci && npm run buildPython
python -m pip install .Java
mvn clean installgo mod edit -replace github.com/pangxin12345/once-email-sdks/sdks/go=./once-email-go-sdk-0.1.0-private.2.NET
dotnet build OnceEmail.Sdk.slncomposer installRuby
bundle install && gem build once_email.gemspecLinux · macOS · Windows
Linux, macOS, Windows 네이티브 CI를 통과했습니다. TypeScript와 Python은 자동 테스트, 나머지는 빌드 또는 구문 검사를 실행합니다.
배포 상태
공개 후보 버전이며 언어별 레지스트리에는 아직 배포하지 않았습니다. 버전을 고정하고 SHA256SUMS를 확인하세요.
각 압축 파일에 코드와 문서가 있으며 MANIFEST.txt와 SHA256SUMS도 제공합니다.
SDK 선택
테스트 서비스의 기존 언어를 사용하세요. 7개 클라이언트는 같은 수신 전용 계약을 따릅니다.
설치 전 검증
불변 버전 압축 파일을 받고 SHA256SUMS와 대조한 뒤 포함된 README를 읽고 버전을 고정하세요.
흐름 제한
승인된 테스트마다 받은편지함을 만들고 기한 내 폴링하며 429/503을 구분하고 메일이나 코드를 기록하지 말고 finally에서 삭제하세요.
전체 사용 가이드
SDK 선택
소유하거나 명시적으로 승인된 앱만 테스트하세요. Once Email은 수신 전용입니다.
문서와 소스는 공개, API는 통제되며 SDK와 Skill은 레지스트리 외 후보 버전입니다. 공개 문서나 프리릴리스 다운로드는 API 접근 권한을 부여하지 않습니다. API 키 생성과 실제 호출은 일반 공개되지 않았습니다.
압축 해제 전 SHA256SUMS를 확인하세요.
정확한 로컬 시작점
README의 로컬 명령을 사용합니다. Registry 설치는 없습니다.
다운로드부터 정리까지
- 승인된 서비스의 기존 언어를 선택합니다.
- 파일을 받고 SHA-256을 검증합니다.
- 버전, 계약, Runtime, 라이선스, 상태를 확인합니다.
- README의 로컬 명령을 사용합니다. Registry 설치는 없습니다.
- 명시적으로 승인된 API 접근 권한과 필요한 최소 권한의 유효한 자격 증명을 이미 받은 경우에만 진행하세요. 자격 증명은 프로세스의 비밀 관리 기능에 보관하세요. 접근 권한이 없다면 문서와 다운로드 내용 검토까지만 진행하세요. Secret에서 키를 주입하고 마감 내 실행합니다.
- finally에서 삭제하고 민감 데이터를 출력하지 않습니다.
실패 및 복구
400/401/403/404/413/429/503, 시간 초과, 모호성, 추출, 검증과 정리를 구분하고 마감 전까지만 재시도하세요.