claims.redeem
POST/claims/facebook
Đổi mã claim của subscriber Facebook lấy quyền subscriber tới hết ngày 5 của tháng sau tháng được cấp mã. Mỗi mã dùng một lần; đổi lại mã mình đã đổi chỉ trả về cùng ngày hết hạn. Cần key của một tài khoản đã xác minh email.
Tham số
| Tham số | Vị trí | Mô tả |
|---|---|---|
code | body | Bắt buộc. Mã claim nhận qua Facebook, dạng FB-XXXX-XXXX-XXXX-XXXX-XXXX. |
Yêu cầu
curl -X POST "https://api.modernengineer.dev/claims/facebook" \
-H "Authorization: Bearer $SE_KEY" \
-H "Content-Type: application/json" \
-d '{"code":"FB-7Q2K-9XHM-4D1R-B8VN-3JTC"}'Phản hồi
{
"accessUntil": "2026-12-05T23:59:59.999Z"
}Lỗi
| Mã | Lỗi | Khi nào |
|---|---|---|
| 401 | unauthenticated | Thiếu API key, hoặc key không hợp lệ. Có kèm header WWW-Authenticate. |
| 403 | forbidden | Email của tài khoản chưa xác minh. |
| 400 | invalid_input | Tham số thiếu hoặc sai, ví dụ locale khác vi và en. |
| 404 | not_found | Mã sai, đã hết hạn, hoặc người khác đã dùng. |
| 429 | too_many_requests | Quá 10 lần thử trong một giờ cho tài khoản này. |