Bắt đầu
Quy ước
- Mọi đường dẫn bên dưới đều tương đối so với URL cơ sở. Yêu cầu và phản hồi là JSON; gửi Content-Type: application/json với POST.
- Id là UUID. Dấu thời gian theo ISO 8601, múi giờ UTC.
- Các trường được gọi theo khóa, một tên dạng snake_case như client_name mà endpoint mẫu trả về bên cạnh mỗi nhãn. Khóa được suy ra từ nhãn khi mẫu được lưu lần đầu và giữ nguyên khi nhãn được viết lại; tác giả có thể đổi khóa trong mẫu.
- Phản hồi mang Cache-Control: no-store và các header CORS cho phép rộng rãi, nên máy khách trên trình duyệt hoạt động được, nhưng trình duyệt không phải nơi để đặt token API.
- API được đánh phiên bản trong đường dẫn. Có thể thêm trường vào phản hồi mà không đổi phiên bản; không có gì bị bỏ hay đổi tên trong v1.