admin_user_requests

Liệt kê user request cho màn hình admin. Đây là một GraphQL query trả về [UserRequest], và cần role ADMIN — xem Endpoint và xác thực.

Input

input: AdminUserRequestInput!

Trường	Kiểu	Bắt buộc	Mô tả
limit	Int	Không	Số dòng mỗi trang. Mặc định 10.
last_id	String	Không	id của dòng cuối cùng ở trang trước. Mặc định "" (trang đầu).
sort	UserRequestsSortInput	Không	field (chỉ có INSERTED_AT, là mặc định) và direction (mặc định DESC). Cùng kiểu với danh sách của người yêu cầu.
code	String	Không	Tìm theo tiền tố, không phân biệt hoa thường. Một code đầy đủ trả về đúng một yêu cầu; fur1234 thu hẹp kết quả. Chuỗi rỗng bị bỏ qua.
claimed	Boolean	Không	true: mọi khoản phí đã paid. false: còn khoản phí chưa thanh toán, hoặc yêu cầu chưa có khoản phí nào. Không gửi để lấy cả hai.

Hai bộ lọc dùng được cùng nhau và cùng với phân trang last_id.

Danh sách admin luôn gửi claimed: false

Một yêu cầu còn nằm trong danh sách cho đến khi add_passenger_fee đã áp dụng mọi khoản phí của nó. Yêu cầu chưa có khoản phí nào — vẫn PENDING, IN_CHARGE, hoặc báo giá trước khi có khoản phí — cũng nằm trong danh sách.

Không có bộ lọc status, nên claimed: false trả về yêu cầu ở mọi trạng thái, không chỉ RESOLVED. Dùng paid của từng khoản phí để hiển thị những khoản còn phải áp dụng.

Query

query {
  admin_user_requests(input: { limit: 20, claimed: false, code: "FUR1234" }) {
    id code status amount currency corporate_amount personal_amount
    fees { id fee_type leg price corporate_amount paid }
  }
}

Có thể lấy mọi trường của object UserRequest.

Mã lỗi

API này không có mã lỗi riêng. Nó có thể trả về Lỗi middleware — UNAUTHORIZED khi người gọi không có role ADMIN.