Tài liệu nhà phát triểnSDK

SDK Once Email

SDK mã nguồn mở dạng ứng viên cho API chỉ nhận thư, đã kiểm thử trên bảy hệ sinh thái.

7 SDK Once Email

TypeScript, Python, Java, Go, .NET, PHP và Ruby dùng chung hợp đồng OpenAPI đã duyệt. Mã nguồn, tài liệu, phiên bản và tệp nén đều công khai.

Linux · macOS · Windows

CI native đã đạt trên Linux, macOS và Windows. TypeScript và Python chạy kiểm thử; các ngôn ngữ khác chạy build hoặc kiểm tra cú pháp.

Trạng thái phát hành

Đây là ứng viên công khai, chưa phát hành lên registry ngôn ngữ. Hãy cố định phiên bản và kiểm tra SHA256SUMS.

Mỗi tệp nén gồm mã và tài liệu, kèm MANIFEST.txt và SHA256SUMS.
Chọn SDK

Dùng ngôn ngữ sẵn có của dịch vụ kiểm thử; bảy client tuân theo cùng hợp đồng chỉ nhận thư.

Xác minh trước khi cài

Tải tệp phiên bản bất biến, đối chiếu SHA256SUMS, đọc README đi kèm và ghim phiên bản.

Giới hạn quy trình

Tạo một inbox cho mỗi kiểm thử được phép, giới hạn polling, tách 429/503, không ghi thư hay mã và luôn xóa inbox trong finally.

Demo SDK

Tải mã, tài liệu và demo

Tệp phiên bản cố định gồm mã, tài liệu, giới hạn và checksum.

Hướng dẫn sử dụng đầy đủ

Chọn SDK

Chỉ kiểm thử ứng dụng của bạn hoặc được ủy quyền. Once Email chỉ nhận email.

Tài liệu và mã nguồn công khai; API được kiểm soát, SDK và Skill là ứng viên ngoài registry. Tài liệu công khai và bản tải xuống trước phát hành không cấp quyền truy cập API. Việc tạo khóa API và gọi API thực tế chưa mở cho công chúng.

Kiểm tra SHA256SUMS trước khi giải nén.

Điểm bắt đầu cục bộ chính xác

Dùng lệnh cục bộ trong README; chưa có cài từ registry.

Từ tải xuống đến dọn dẹp

  1. Chọn ngôn ngữ của dịch vụ được phép.
  2. Tải tệp và xác minh SHA-256.
  3. Kiểm tra phiên bản, hợp đồng, runtime, giấy phép, trạng thái.
  4. Dùng lệnh cục bộ trong README; chưa có cài từ registry.
  5. Chỉ tiếp tục khi đã được cấp quyền truy cập API rõ ràng và thông tin xác thực hợp lệ với quyền tối thiểu cần thiết. Lưu chúng trong cơ chế quản lý bí mật của tiến trình; nếu chưa có quyền truy cập, chỉ xem tài liệu và nội dung tải xuống. Nạp khóa từ secret và chạy trong hạn chót.
  6. Xóa trong finally và không in dữ liệu nhạy cảm.

Lỗi và khôi phục

Phân biệt 400/401/403/404/413/429/503, timeout, mơ hồ, trích xuất, kiểm tra và dọn dẹp. Chỉ thử lại trong một hạn chót.