# 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.

Nguồn: https://whypik.com/docs/data-rest
Nhóm: Lập trình viên
Phiên bản tài liệu: 2026-10-14.10
Ngôn ngữ: vi

## Địa chỉ và xác thực

Liên kết mục: https://whypik.com/docs/data-rest#section-0

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

Liên kết mục: https://whypik.com/docs/data-rest#section-1

```
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

Liên kết mục: https://whypik.com/docs/data-rest#section-2

| 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

Liên kết mục: https://whypik.com/docs/data-rest#section-3

Đọ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.


## Đọc tiếp

- [Data API: chọn cột, lọc và phân trang](https://whypik.com/docs/data-queries)
- [Quan hệ: include và lọc qua bảng liên kết](https://whypik.com/docs/data-relations)
- [Thêm, sửa, xóa bằng SDK](https://whypik.com/docs/data-writes)
- [Lỗi, timeout và chẩn đoán SDK](https://whypik.com/docs/sdk-errors)