الموارد وعناوين URL

جزء من قسم واجهات REST API في رحلة Node.js على Coddy. الدرس 1 من 18.

يستدعي مبرمجون آخرون واجهة API البرمجية من شيفرتهم، لذا يجب أن يكون من السهل تخمين عناوينها. تتبع معظم واجهات API البرمجية أسلوبًا يُسمى REST: يحدد كل عنوان شيئًا، أي موردًا، ويحدد أسلوب HTTP ما يجب فعله به.

GET    /api/invoices      the list of invoices
GET    /api/invoices/7    invoice 7
POST   /api/invoices      add an invoice
DELETE /api/invoices/7    remove invoice 7

يحتوي المسار على أسماء، وليس أفعالًا أبدًا. باستخدام /api/getInvoices و/api/deleteInvoice?id=7، يتعين على العميل تعلّم كلمة جديدة لكل إجراء. يجيب موجّه مثبّت باستخدام app.use('/api/invoices', invoices) عن كلا العنوانين: المسار '/' هو القائمة، والمسار '/:id' هو فاتورة واحدة. إذا لم يطابق المعرّف أي شيء، فستكون الإجابة 404 مع خطأ بصيغة JSON، ليتمكن العميل من قراءته مثل أي إجابة أخرى.

التحدي

سهل

ركّب الموجّه في server.js على المسار /api/tasks.
يعيد GET /api/tasks المصفوفة من store.js.
يعيد GET /api/tasks/:id مهمة واحدة، أو 404 مع { "error": "Task not found" }.

اضغط على تشغيل وأرسل GET /api/tasks وGET /api/tasks/2 وGET /api/tasks/99.

جرّب بنفسك

import { Router } from 'express';
import { tasks } from '../store.js';

const router = Router();

// أضف مسارًا للقائمة كاملةً ومسارًا لمهمة واحدة

export default router;