بعد از این درس دقیقاً چه بلدی؟
- موضوع «Resource» را با زبان ساده برای فرد دیگری توضیح میدهی.
- مثال همین درس را خطبهخط میخوانی و خروجی آن را پیشبینی میکنی.
- کد را تغییر میدهی، نتیجه یا ساختار آن را بررسی میکنی و خطا را مرحلهای اصلاح میکنی.
باجه خدمات با فرم استاندارد
هر خدمت نشانی و عملیات مشخص دارد و رسید نتیجه را با وضعیت روشن تحویل میدهد.
API منابع را با URLهای پایدار و روشهای HTTP مدیریت میکند. پاسخ باید Status Code، Content-Type و بدنهای سازگار با نتیجه واقعی داشته باشد.
چرا مهم است؟ این مفهوم یکی از آجرهای مسیر حرفهای PHP است. فعلاً لازم نیست همه جزئیات را حفظ کنی؛ باید دلیل استفاده و اثر هر خط را بفهمی.
اولین تمرین تو: POST /orders داده معتبر را میگیرد، سفارش میسازد و با 201 و Location نشانی منبع تازه را برمیگرداند.
اول بفهم، بعد کد بنویس
Resource
مفهومی مانند users یا orders با شناسه پایدار است.
Idempotency
تکرار عملیات امن همان اثر نهایی را دارد.
Status code
موفقیت یا نوع شکست را در سطح HTTP بیان میکند.
API ساخت سفارش
POST /orders داده معتبر را میگیرد، سفارش میسازد و با 201 و Location نشانی منبع تازه را برمیگرداند.
قطعهها را به ترتیب درست بچین
روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمههای جابهجایی هم میتوانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.
کد را کامل کن و ساختار آن را بررسی کن
این درس وارد قابلیتهای سروری یا حرفهای شده است. برای امنیت سایت، کد دلخواه روی سرور اجرا نمیشود؛ بررسیگر، وجود اجزای ضروری و منطق مورد انتظار را کنترل میکند و راهنمای اصلاح میدهد.
کد را کامل کن و «بررسی ساختار» را بزن.
این مثال خطبهخط چه میگوید؟
فعلاً حفظ نکن؛ هر خط را به یک جمله ساده تبدیل کن.
- 1
<?phpاز اینجا مفسر PHP شروع به خواندن کد میکند.
- 2
http_response_code(201);این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 3
header("Content-Type: application/json; charset=utf-8");این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 4
header("Location: /api/orders/204");این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 5
echo json_encode([نتیجه این عبارت به خروجی پاسخ فرستاده میشود.
- 6
"data" => ["id" => 204, "status" => "draft"],این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 7
], JSON_THROW_ON_ERROR);این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
راهنماییها مرحلهای هستند؛ اول خودت پیام خطا را بخوان.
پاسخهای 404، 409 و 422 را برای حالتهای واقعی سفارش تعریف کن.
از ساده به چالشی، بدون پرش
یکی از مقدارهای مثال را عوض کن، خروجی را روی کاغذ حدس بزن و سپس بررسی کن.
پاسخهای 404، 409 و 422 را برای حالتهای واقعی سفارش تعریف کن.
سناریوی «API ساخت سفارش» را با نامهای واضحتر و یک حالت تازه گسترش بده.
این سه اشتباه را انجام نده
POST برای همه عملیات
برگرداندن 200 همراه متن خطا
تغییر مداوم شکل Response بدون نسخهگذاری
5 پرسش کوتاه؛ مطمئن شو واقعاً یاد گرفتهای
برای هر پرسش یک پاسخ انتخاب کن. بعد از هر انتخاب، دلیل پاسخ را همانجا میبینی.
کد مناسب ساخت موفق منبع چیست؟
کدام توضیح، «Resource» را دقیقتر بیان میکند؟
بهترین قدم بعد از خواندن مثال این درس چیست؟
کدام روش نشان میدهد این درس را واقعاً فهمیدهای؟
کدام رفتار احتمال خطا را در همین موضوع بیشتر میکند؟
درس را فقط وقتی تمام کن که کد را تغییر دادهای
دیدن آموزش کافی نیست؛ یک مقدار را تغییر بده، خروجی را پیشبینی کن و بعد اجرا بزن.