REST

توضیح

در REST، هر resource، مثل یک سند، از راه یک رابط یکسان در دسترس است و client با نمایش آن، مثلاً در قالب JSON، کار می‌کند. در کاربرد رایج روی HTTP، آدرس‌ها resource را مشخص می‌کنند و method‌هایی مثل GET و DELETE نوع عملیات را نشان می‌دهند. هر درخواست باید اطلاعات لازم برای پردازش خودش را داشته باشد و به سابقهٔ درخواست‌های قبلی وابسته نباشد. REST قیدهای دیگری مثل قواعد cache هم دارد؛ پس هر API مبتنی بر HTTP لزوماً RESTful نیست.

مثال

// دریافت نمایش یک resource از API
const response = await fetch('/api/books/42');
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const book = await response.json();

چرا مهمه

هنگام طراحی یا استفاده از API با REST روبه‌رو می‌شوی؛ شناخت آن به تو کمک می‌کند رابطی قابل‌فهم و توسعه‌پذیر بسازی و RESTful بودن را با صرفاً استفاده از HTTP یکی ندانی.

مفهوم‌های مرتبط

• API
• HTTP
• cache
• CRUD
• idempotent