العنوان والصيغة
كل المسارات تحت https://new-wasmenia-4zjd6l.cranl.net/api/v1، وتجيب بـ JSON بترميز UTF-8. لا مفتاح ولا تسجيل، والطلبات كلها GET.
- الأسماء باللغتين:
name.arموجود دائمًا، وname.enقد يكونnull. - الحقل غير المعروف يأتي
null، والقائمة الفارغة[]. - الروابط في الردود كاملة، لا مسارات نسبية.
1. ابحث باسم الجهة
curl -sS -G 'https://new-wasmenia-4zjd6l.cranl.net/api/v1/search/suggest' \ --data-urlencode 'q=الاتصالات'ما يعود من البحث
{ "total": 3, "items": [ { "id": "…", "slug": "stc", "nameAr": "…", "nameEn": "…", "thumbUrl": "https://…/thumb.webp", "isVerified": true, "matchedKind": "name_ar" } ]}احفظ slug: به تقرأ السجل الكامل. وإن غيّرت الجهة عنوانها في الأرشيف، يحوّل العنوان القديم إلى الجديد بـ 308، والمتصفح وأغلب المكتبات تتبعه.
2. اقرأ السجل
curl -sS 'https://new-wasmenia-4zjd6l.cranl.net/api/v1/brands/stc'التالي
- السجل والحقول الغائبة: كل حقل وما يعنيه حين يغيب.
- منتقي جهة في نموذج: البحث أثناء الكتابة.
- الشعار المناسب للخلفية: أي ملف تعرض.
- المرجع: كل مسار بمعاملاته وحالاته، و«جرّبها».