Lập trình viên / Tra cứu
REST Data API
Dùng cho ngôn ngữ chưa có SDK. Endpoint public vẫn kiểm tra key, user token và policy.
Địa chỉ và xác thực
POST https://app.whypik.com/api/v1/data/PROJECT_UUID/TABLE/select|insert|update|delete. Trên WhyPik Hosting có /.whypik/data/TABLE/ACTION cùng origin. Content-Type:application/json, X-WhyPik-Key:wpk_public_..., Authorization:Bearer ACCESS_TOKEN khi có user. Không dùng wpc_ quản lý thay public key.
Public key chỉ chọn Project; anonymous cần policy. Token hỏng không tự hạ xuống anonymous. Server secret chỉ ở backend tin cậy với server policies; không gửi secret kèm browser Origin.
Payload đọc
POST /api/v1/data/PROJECT_UUID/players/select
{
"columns":["id","nickname"],
"filter":{"server__id":"1"},
"order":["-modified","id"],
"limit":50,
"include":{"server":{"columns":["id","name"]}}
}
// Trang sau: thêm "cursor":"NEXT_CURSOR" với cùng query.Payload ghi
| Action | JSON |
|---|---|
| insert | {"values":{"title":"Hello","owner_id":"USER_UUID"},"returning":["id"]} |
| update | {"filter":{"id":"ROW_UUID"},"values":{"title":"New"}} |
| delete | {"filter":{"id":"ROW_UUID"}} |
Response và lỗi
Đọc: data + page(limit,next_cursor,revision) + request_id. Ghi: data(null nếu không returning), affected, revision, request_id. HTTP lỗi dùng error/message/request_id và thông tin retry/outcome nếu có. Không xem lỗi gateway HTML/timeout như rollback. Request tối đa kỹ thuật 256 KiB; response 5 MiB; giới hạn plan vẫn áp dụng.