بعد از این درس دقیقاً چه بلدی؟
- میتوانی «JSON» را با مثال همین درس توضیح بدهی.
- میدانی «Endpoint» کجای مسئله به کار میآید.
- تغییر پیشنهادی درس را اجرا میکنی و از روی نتیجه، اشتباه را پیدا میکنی.
فهرست استاندارد برای پیک
بهجای تزئین ویترین، انبار یک فهرست مرتب از نام، تعداد و شناسه تحویل میدهد تا برنامه دیگر بتواند بدون حدس آن را بخواند.
اپ موبایل به صفحه کامل HTML نیاز ندارد؛ دادهای ساختیافته میخواهد. API درخواست را میگیرد و معمولاً JSON همراه با کد وضعیت درست برمیگرداند.
چرا مهم است؟ API بهجای HTML یک آرایه از کارها را به JSON تبدیل میکند و نوع پاسخ را مشخص میکند.
اولین تمرین تو: API بهجای HTML یک آرایه از کارها را به JSON تبدیل میکند و نوع پاسخ را مشخص میکند.
اول بفهم، بعد کد بنویس
JSON
قالب متنی رایجی برای فرستادن آرایهها و مقدارها میان برنامههاست.
Endpoint
یک نشانی مشخص برای یک منبع یا کار؛ مثل /api/tasks.
Status code
با عددهایی مثل 200، 201، 404 و 422 نتیجه درخواست را روشن میکند.
پاسخ فهرست کارها
API بهجای HTML یک آرایه از کارها را به JSON تبدیل میکند و نوع پاسخ را مشخص میکند.
قطعهها را به ترتیب درست بچین
روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمههای جابهجایی هم میتوانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.
کد را کامل کن و ساختار آن را بررسی کن
این درس وارد قابلیتهای سروری یا حرفهای شده است. برای امنیت سایت، کد دلخواه روی سرور اجرا نمیشود؛ بررسیگر، وجود اجزای ضروری و منطق مورد انتظار را کنترل میکند و راهنمای اصلاح میدهد.
کد را کامل کن و «بررسی ساختار» را بزن.
این مثال خطبهخط چه میگوید؟
فعلاً حفظ نکن؛ هر خط را به یک جمله ساده تبدیل کن.
- 1
<?phpاز اینجا مفسر PHP شروع به خواندن کد میکند.
- 2
header("Content-Type: application/json; charset=utf-8");این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 3
$tasks = [یک مقدار با نام $tasks نگهداری میشود تا در خطهای بعد دوباره استفاده شود.
- 4
["id" => 1, "title" => "خرید کتاب", "done" => false],این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 5
];این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 6
echo json_encode($tasks, JSON_UNESCAPED_UNICODE);نتیجه این عبارت به خروجی پاسخ فرستاده میشود.
راهنماییها مرحلهای هستند؛ اول خودت پیام خطا را بخوان.
یک کار دوم اضافه کن. بعد یک مقدار غیرقابلکدگذاری بساز و json_last_error_msg را برای تشخیص خطا بررسی کن.
از ساده به چالشی، بدون پرش
یکی از مقدارهای مثال را عوض کن، خروجی را روی کاغذ حدس بزن و سپس بررسی کن.
یک کار دوم اضافه کن. بعد یک مقدار غیرقابلکدگذاری بساز و json_last_error_msg را برای تشخیص خطا بررسی کن.
سناریوی «پاسخ فهرست کارها» را با نامهای واضحتر و یک حالت تازه گسترش بده.
این سه اشتباه را انجام نده
همراه JSON متن یا HTML اضافی echo میکنی.
برای همه نتیجهها کد وضعیت 200 میفرستی.
ساختار پاسخ موفق و خطا را در هر endpoint متفاوت میسازی.
5 پرسش کوتاه؛ مطمئن شو واقعاً یاد گرفتهای
برای هر پرسش یک پاسخ انتخاب کن. بعد از هر انتخاب، دلیل پاسخ را همانجا میبینی.
برای ساختهشدن موفق یک منبع تازه کدام کد معمول است؟
کدام توضیح، «JSON» را دقیقتر بیان میکند؟
بهترین قدم بعد از خواندن مثال این درس چیست؟
کدام روش نشان میدهد این درس را واقعاً فهمیدهای؟
کدام رفتار احتمال خطا را در همین موضوع بیشتر میکند؟
درس را فقط وقتی تمام کن که کد را تغییر دادهای
دیدن آموزش کافی نیست؛ یک مقدار را تغییر بده، خروجی را پیشبینی کن و بعد اجرا بزن.