تجربة APIs جاهزة
قبل أن تبني API خاصًا بك، تعلّم أن تستعمل واجهات جاهزة. ستحتاج هذا في كل مشروع: بوابات دفع، وخدمات شحن، وخرائط، ورسائل.
قراءة توثيق API
كل API جيد له توثيق (Documentation). ابحث فيه دائمًا عن:
- العنوان الأساسي (Base URL): مثل
https://api.example.com/v1. - نقاط الوصول (Endpoints): المسارات المتاحة وطريقة كل منها.
- المعاملات: ما يُرسل في الرابط (
?page=2)، وما يُرسل في الجسم. - المصادقة: كيف تثبت هويتك؛ غالبًا مفتاح في ترويسة.
- أمثلة الاستجابة والأخطاء: شكل البيانات التي سترجع.
- الحدود: كم طلبًا مسموحًا في الدقيقة أو اليوم.
تجربة الطلبات
قبل كتابة أي كود، جرّب الطلب بأداة:
- Thunder Client: إضافة داخل VS Code، خفيفة وكافية.
- Postman: أداة كاملة لحفظ مجموعات الطلبات ومشاركتها.
- curl من الطرفية:
curl https://jsonplaceholder.typicode.com/posts/1
curl -X POST https://jsonplaceholder.typicode.com/posts \
-H "Content-Type: application/json" \
-d '{"title": "تجربة", "body": "نص", "userId": 1}'
الطلب الثاني يرسل بيانات بطريقة POST، والخدمة التجريبية ترد بكود 201 وكأنها أنشأت العنصر.
مفاتيح الـ API وحمايتها
أغلب الواجهات الحقيقية تطلب مفتاحًا (API Key)، يُرسل عادة في ترويسة:
curl https://api.example.com/v1/orders \
-H "Authorization: Bearer YOUR_API_KEY"
ثلاث قواعد لا تتنازل عنها:
- لا تضع المفتاح السري في كود الواجهة (JavaScript في المتصفح)؛ أي زائر يستطيع قراءته من أدوات المطوّر. الطلبات التي تحتاج مفتاحًا سريًا تمر عبر خادمك.
- لا ترفعه إلى GitHub؛ ضعه في ملف
.envمذكور في.gitignore. - إذا تسرّب، ألغه فورًا من لوحة الخدمة وأنشئ مفتاحًا جديدًا.
حدود الاستعمال
كثير من الخدمات تحدد عدد الطلبات (Rate Limit). إذا تجاوزته يصلك كود 429 Too Many Requests، وغالبًا ترويسة تخبرك متى تحاول مجددًا. لا تجلب نفس البيانات في كل زيارة؛ احفظ النتيجة مؤقتًا إذا كانت لا تتغير كثيرًا.
مهمتك
ثبّت Thunder Client، وجرّب على JSONPlaceholder طلبًا من كل نوع: GET لقائمة، و GET لعنصر واحد، و POST و PUT و DELETE. سجّل كود الحالة الذي يرجع في كل مرة، وقارنه بما تعلمته في الفصل الأول.