REST API

Xây dựng trên nền các dự án Skimle của bạn

Các endpoint JSON để đọc và ghi dữ liệu dự án, và để chạy một dự án từ đầu đến cuối. Xác thực bằng khóa Bearer, gửi một hành động và nhận lại JSON.

Bắt đầu trong ba bước

Từ con số không đến lệnh gọi đã xác thực đầu tiên.

Tạo khóa API

Khóa dự án truy cập một dự án. Khóa tài khoản truy cập một nhóm và có thể tạo dự án trong đó. Cả hai đều có cấp đọc và cấp chỉnh sửa.

1. Mở trang khóa API
2. Chọn dự án mà khóa sẽ truy cập và chọn quyền đọc hoặc chỉnh sửa
3. Sao chép khóa: Skimle chỉ lưu giá trị băm của khóa

Hãy sao chép khóa ngay.

Giá trị đầy đủ của khóa chỉ hiển thị một lần khi tạo. Sau khi đóng hộp thoại, phía chúng tôi chỉ còn giá trị băm, nên khóa bị mất sẽ phải được cấp lại.

Gửi yêu cầu đầu tiên

Truyền khóa dưới dạng token Bearer và hành động trong phần thân JSON. Mọi endpoint đều nhận JSON và trả về JSON.

curl -X POST https://app.skimle.com/api/skimle-read \
  -H "Authorization: Bearer skm_…r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "get_categories" }'

Khóa đọc kết thúc bằng r, khóa chỉnh sửa kết thúc bằng e. Khóa dự án gọi /api/skimle-read và /api/skimle-write. Khóa tài khoản gọi /api/skimle-account.

Mở tài liệu tham khảo API

Duyệt mọi endpoint kèm mô tả, cấu trúc yêu cầu và bảng dùng thử. Mỗi tuyến nhận phần thân dạng union phân biệt theo trường action.

Mở tài liệu tham khảo Endpoint đọc →Endpoint ghi →Endpoint dự án →

Bản đặc tả OpenAPI 3.1 gốc có tại /api/openapi.json.

Sẵn sàng xây dựng?

Quản lý khóa dự án, hoặc xem máy chủ MCP dành cho các ứng dụng tác tử.

Tạo khóa API Dùng MCP thay thế