Nhà phát triển
API đã có. Tài liệu tham chiếu công khai thì chưa.
Mọi thứ trên nền tảng này (cửa hàng, giỏ hàng, bảng điều khiển) đều đã giao tiếp với cùng một API. Điều chúng tôi chưa làm là công bố nó: hiện chưa có token cho khách hàng và chưa có tài liệu tham chiếu, và chúng tôi thà nói thẳng điều đó còn hơn bán cho bạn một ảnh chụp màn hình.
Hiện nay
Điều gì thực sự đúng vào lúc này.
Cửa hàng và bảng điều khiển đã chạy trên API nội bộ của chúng tôi. Công bố nó đồng nghĩa với tài liệu, cấp token và những cam kết ổn định mà chúng tôi giữ được, và hiện chưa có điều nào trong số đó.
Những gì chưa có: khóa API bạn tự tạo, tài liệu tham chiếu công bố kèm schema, và các cam kết ổn định khiến một API đáng để xây dựng dựa trên. Cho đến khi có thể ghi chính sách phiên bản và ngừng hỗ trợ thành văn bản, chúng tôi sẽ không cấp token: một API thay đổi bất ngờ còn tệ hơn không có API.
Nếu quy trình của bạn cần khởi tạo bằng chương trình ngay hôm nay, hãy cho chúng tôi biết bạn đang xây dựng gì qua biểu mẫu yêu cầu. Mức độ quan tâm thực sự quyết định thứ tự chúng tôi phát triển, và quyền truy cập sớm sẽ dành trước cho những người đã hỏi.
Phạm vi dự kiến
Những gì API công khai sẽ bao gồm.
Đây là những khả năng API nội bộ đã có và API công khai sẽ cung cấp. Dự kiến nghĩa là dự kiến: hiện khách hàng chưa thể gọi bất kỳ phần nào.
- Vòng đời máy chủ
- Tạo, cài lại, khởi động lại nguồn và xóa máy chủ từ mã của bạn: các thao tác mà bảng điều khiển đang thực hiện hiện nay.
- Danh mục trực tiếp
- Các gói, khu vực và image dưới dạng dữ liệu, với cùng mức giá cửa hàng hiển thị, kể cả chiết khấu đối tác nếu có.
- Tên miền và DNS
- Tìm kiếm, đăng ký và quản lý bản ghi qua cùng tích hợp nhà đăng ký mà trang web đang dùng.
- Mức sử dụng và tính phí
- Số liệu đo theo từng giờ mà bạn đọc được bằng chương trình: những con số bạn cần để tính phí lại cho khách hàng của mình.
- Webhook, không phải polling
- Sự kiện vòng đời được đẩy tới endpoint của bạn và có chữ ký, để hệ thống của bạn phản ứng thay vì phải hỏi.
- Token theo phạm vi
- Khóa chỉ đọc, chỉ khởi tạo hoặc toàn quyền, thu hồi được ngay lập tức, kèm nhật ký kiểm tra theo từng token.
Các nguyên tắc chúng tôi hướng tới: REST đơn giản với mã trạng thái có ý nghĩa, khóa idempotency cho các lệnh thay đổi dữ liệu, cloud-init user_data khi tạo máy, giới hạn tần suất ghi trong header phản hồi, và thông báo lỗi chỉ rõ bạn cần làm gì tiếp theo. Nhàm chán một cách có chủ đích.
Đăng ký quan tâm
Hãy cho chúng tôi biết bạn sẽ xây dựng gì với nó.
Một câu về trường hợp sử dụng của bạn là đủ. Chúng tôi sẽ liên hệ khi có thứ thực sự để dùng thử, không phải một chuỗi email tiếp thị.