تست و اجرا با GraphQL Playground یا GraphiQL
پس از اتصال GraphQL به FastAPI، می‌توانیم Query و Mutationهای کاربران و تسک‌ها را بدون احراز هویت تست کنیم. با اجرای پروژه، FastAPI مسیر /graphql را ارائه می‌دهد که با باز کردن آن در مرورگر، محیط تعاملی GraphQL (Playground یا GraphiQL) قابل استفاده است.
# running service
fastapi dev --host 0.0.0.0 --port 8000
آدرس تست:
http://localhost:8000/graphql
نمونه Query برای خواندن کاربران
{
users {
id
email
createdAt
updatedAt
tasks {
id
title
isCompleted
}
}
}
نمونه Query برای خواندن تسک‌ها
{
tasks {
id
title
description
isCompleted
ownerId
}
}
نمونه Mutation برای ایجاد کاربر جدید
mutation {
createUser(email: "user@example.com", password: "123456") {
id
email
createdAt
}
}
نمونه Mutation برای ایجاد Task جدید مرتبط با کاربر
mutation {
createTask(title: "First Task", userId: 1, description: "Task description") {
id
title
description
isCompleted
userId
}
}
با این تست‌ها، می‌توانیم مطمئن شویم که:
- Query
usersوtasksداده‌ها را درست برمی‌گردانند. - Mutationها داده‌ها را در دیتابیس ایجاد می‌کنند و خروجی درست را بازمی‌گردانند.
- ارتباط Task با User به درستی برقرار شده است.
در مراحل بعد می‌توانیم احراز هویت، ولیدیشن پیچیده‌تر و Query/Mutationهای پیشرفته‌تر را اضافه کنیم.