فصل ۱ — مبانی API و HTTP

HTTP برای API — متد، کد وضعیت و هدر API چیست: قرارداد بین دو برنامه متدها: GET، POST، PUT، PATCH، DELETE کدهای وضعیت: زبان پاسخ سرور هدرهای مهم: Accept، Content-Type و CORS قراردادهای JSON: snake_case، تاریخ و پول REST در برابر RPC-style: انتخاب آگاهانه نگاهی به GraphQL: چه وقت ارزش دارد؟ چک‌لیست تصمیم API: REST یا GraphQL یا gRPC؟

فصل ۲ — طراحی REST

منابع، آدرس‌ها و ساختار REST درست منابع REST: اسم‌محور و روابط فیلتر و مرتب‌سازی و صفحه‌بندی Cursor pagination: feedهای پایدار فرمت خطا: code، message و fieldها مستندسازی با OpenAPI شناسه‌های عمومی: UUID، slug و امنیت URL

فصل ۳ — امنیت و نسخه‌بندی

احراز API: API Key، JWT و OAuth 2 نسخه‌بندی، CORS و مدیریت خطای منظم API Key: ساده اما با قواعد JWT در API: access، refresh و revoke OAuth 2.0 برای APIهای عمومی CORS در عمل: فرانت و API جدا نسخه‌بندی: /v1 و سیاست تغییر rate limit عملی: لایه‌ها و پاسخ اعتبارسنجی مرکزی با middleware شکل‌دهی پاسخ: فیلدهای خروجی و مخفی‌سازی

فصل ۴ — مصرف API و کیفیت

مصرف API از فرانت: fetch، retry و حالت‌های UI مصرف از فرانت: fetch با wrapper retry و backoff و timeout Idempotency-Key: تکرار امن POST SSE و streaming پاسخ Webhook: دریافت رویداد با تأیید امضا لایه API کلاینت: توابع endpoint تایپ‌دار مصرف در اپ موبایل: token و offline WebSocket در معماری API مصرف API از سمت سرور: Node/PHP

فصل ۵ — عملیات و کیفیت

پایش API: لاگ، متریک و trace cache در API: هدرها و cache-aside پاسخ لیست: meta، cursor و شمارش تست endpointها: integration با داده واقعی SDK و کلاینت‌های آماده برای مصرف‌کنندگان محیط‌ها: dev، staging و prod تغییر schema در API زنده تست بار: autocannon و نقاط شکست Pool اتصال دیتابیس در API کارهای دوره‌ای API: کرون و صف گزارش فیلدهای انتخابی و پاسخ سبک بازبینی API در تیم: چک‌لیست PR

فصل ۶ — پروژه: API فروشگاه

سؤال‌های مصاحبه API: پاسخ‌های کوتاه چک‌لیست نهایی API حرفه‌ای پروژه: schema و منابع فروشگاه پروژه: ساخت سفارش با موجودی و تراکنش پروژه: اتصال درگاه و callback امن پروژه: مستندسازی، تست و انتشار

پروژه عملی پایان دوره

پروژه پایانی — API فروشگاه کوچک با احراز، CORS و مستندات
API & REST Tutorial فصل ۴ — مصرف API و کیفیت درس آموزشی

Webhook: دریافت رویداد با تأیید امضا

درگاه/سرویس به شما خبر می‌دهد؛ endpoint webhook با verify signature و idempotency — پرداخت با webhook می‌آید نه redirect.

مراحل قدم‌به‌قدم

  1. ۱

    پایه

    POST /api/webhooks/pay با raw body؛ verify HMAC با secret مشترک؛ 200 سریع، پردازش در صف — پاسخ کند = retry بی‌رویه.

  2. ۲

    raw body برای امضا

    قبل از express.json body خام لازم؛ در PHP file_get_contents("php://input") — امضا روی بایت خام است نه پارس‌شده.

  3. ۳

    idempotency

    event id یکتا؛ تکرار را بی‌اثر پاسخ 200 — درگاه retry می‌زند وگرنه سفارش دوباره پرداخت می‌شود.

  4. ۴

    صف و replay

    پردازش در صف؛ لاگ رویدادها؛ replay دستی با admin tool — webhook گم‌شده را بازپخش کنید.

نکات مهم

  • ◆ verify HMAC روی raw body؛ 200 سریع و پردازش صف.
  • ◆ idempotency با event id — retry درگاه را می‌بندد.
  • ◆ لاگ و replay برای رویدادهای گم‌شده.

کد یا مسیر نمونه

app.post("/api/webhooks/pay", express.raw({ type: "*/*" }), (req, res) => {
  const sig = req.headers["x-pay-signature"];
  const expect = crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expect))) return res.sendStatus(400);
  queue.add("pay", JSON.parse(req.body));
  res.sendStatus(200);
});

اجرای زنده کد JavaScript

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.