Tạo một cấp bậc API
Các endpoint tùy chỉnh và queries được lưu trữ có thể được tổ chức thành một cấp bậc. Điều này đạt được khi chúng khai báo một phần tử cha, trong trường hợp đó các đường dẫn endpoint của chúng sẽ mở rộng từ đường dẫn endpoint của phần tử cha.
Ví dụ, chúng ta có thể tạo cấp bậc sau:
- Queries được lưu trữ cha:
/graphql-query/posts/ - Queries được lưu trữ con:
/graphql-query/posts/english/ - Queries được lưu trữ con:
/graphql-query/posts/french/
Số cấp độ là không giới hạn, vì vậy chúng ta cũng có thể tạo:
/graphql-query/posts//graphql-query/posts/mobile-app//graphql-query/posts/mobile-app/english//graphql-query/posts/mobile-app/french//graphql-query/posts/website//graphql-query/posts/website/english//graphql-query/posts/website/french/
Xem hướng dẫn Chiến lược cho cấp bậc API để xem các cấu hình có thể.
Kế thừa thuộc tính
Các endpoint tùy chỉnh và queries được lưu trữ con sẽ kế thừa các thuộc tính từ phần tử cha.
Endpoint tùy chỉnh và queries được lưu trữ
Các endpoint tùy chỉnh và queries được lưu trữ con sẽ kế thừa cấu hình schema của phần tử cha.
Chỉ dành cho queries được lưu trữ
Các queries được lưu trữ con cũng sẽ kế thừa GraphQL query và các biến của phần tử cha. Giá trị của các biến có thể được ghi đè bởi phần tử con, từng biến một.
Ví dụ, nếu phần tử cha khai báo các biến sau:
{
"limit": 5,
"offset": 0
}Và phần tử con khai báo các biến sau:
{
"limit": 10
}Thì các biến được tính toán cho phần tử con sẽ là:
{
"limit": 10,
"offset": 0
}Tạo một cấp bậc API
Trong endpoint tùy chỉnh hoặc queries được lưu trữ, trong phần cài đặt Tài liệu, có mục Thuộc tính trang với danh sách thả xuống của tất cả các thực thể khác để chọn làm phần tử cha:
Queries được lưu trữ
Khi chọn một phần tử cha, queries được lưu trữ sẽ cung cấp một tùy chọn mới, "Inherit query from ancestor(s)?"
Đặt tùy chọn này thành Yes, để queries được lưu trữ con kế thừa GraphQL query của phần tử cha:
Ví dụ
Queries được lưu trữ này định nghĩa GraphQL query của nó và khai báo biến $limit với giá trị 1:
Một queries được lưu trữ con mở rộng nó, kế thừa GraphQL query và ghi đè giá trị của biến $limit thành 2:
