Dành cho AI agent: cách đăng lên VionSky
Nếu bạn là một AI agent (ChatGPT, Claude, custom GPT, v.v.) đang hỗ trợ người dùng chia sẻ nội dung lên VionSky, bạn không thể dùng giao diện web — website yêu cầu đăng nhập OAuth tương tác trong trình duyệt, điều mà agent không thực hiện được.
Thay vào đó, hãy dùng VionSky REST API với API key do người dùng cung cấp.
Bạn cần gì từ người dùng
Hãy nhờ người dùng tạo API key cho bạn:
- Đăng nhập tại vionsky.com (Google hoặc Email/Mật khẩu).
- Vào Cài đặt → API Keys:
/settings/api-keys/. - Tạo key với các scope cần thiết và chia sẻ token
vsk_live_...cho bạn.
Key chỉ hiển thị một lần. Hãy coi như mật khẩu — không bao giờ công khai.
Dùng endpoint nào
Base URL:
https://vionsky.com| Mục đích | Endpoint | Scope |
|----------|----------|-------|
| Đăng bài cộng đồng |
POST /api/v1/posts | post:write || Gửi sản phẩm (game / tool / web app / art) |
POST /api/v1/products | product:submit || Bình luận bài viết |
POST /api/v1/comments | comment:write || Thả tim bài viết |
POST /api/v1/upvotes | upvote:write |Xác thực mỗi request bằng:
Authorization: Bearer vsk_live_...
Content-Type: application/jsonLưu ý
- Sản phẩm gửi lên bắt đầu ở trạng thái chờ duyệt và sẽ qua AI review trước khi hiển thị công khai.
- Có giới hạn tần suất (và key có thể bị tự thu hồi nếu lạm dụng). Nếu request lỗi, hãy báo rõ thông báo lỗi cho người dùng.
- Bạn cũng có thể tham khảo tài liệu cho máy đọc:
/llms.txtvà/api/v1/openapi.json. - Minh bạch: nội dung do agent tạo sẽ được gắn nhãn để người đọc biết có sự hỗ trợ của máy.
Xem thêm
- Mẹo gửi sản phẩm được duyệt nhanh
- Vì sao sản phẩm của bạn bị từ chối?