انتقل إلى المحتوى
وسمينيا للمطورين
في هذه الصفحة

البحث بالاقتراح

اقتراح علامات بالاسم

GET/api/v1/search/suggest

يبحث في أسماء العلامات المنشورة بالعربية والإنجليزية وأسمائها البديلة واختصاراتها وأسمائها السابقة، ويعيد حتى 8 نتائج مرتبة بالأقرب. مصمم للبحث أثناء الكتابة: أرسل الطلب بعد حرفين على الأقل وبعد توقف قصير.

المفتاح
مطلوب في ترويسة Authorization. لا يُحسب سحبًا.
حدود الطلبات
بمفتاح: حد باقتك في الدقيقة. بلا مفتاح: 90 طلبًا كل 60 ثانية لكل عنوان IP.
التخزين المؤقت
private, max-age=30
CORS
يُقرأ من أي موقع (CORS)

المعاملات

  • q

    stringفي الاستعلاممطلوب

    ما يكتبه المستخدم. أقل من حرفين يعيد نتيجة فارغة دون أن يُحسب طلبًا، وما زاد على 120 حرفًا يُقص.

    حتى 120 · الأطول يُقص

الاستجابة

  • totalinteger

    عدد كل العلامات المطابقة، وإن عادت 8 منها فقط.

  • tokstring | null

    محجوز لإحصاءات الموقع نفسه. تجاهله.

  • itemsarray<object>

    النتائج، الأقرب أولًا.

    • idstring

      معرّف العلامة الثابت.

    • slugstring

      المعرّف النصي؛ به تقرأ السجل الكامل.

    • nameArstring

      الاسم بالعربية.

    • nameEnstring | null

      الاسم بالإنجليزية، إن عُرف.

    • countryCodestring | null

      رمز الدولة من حرفين.

    • categoryNameArstring | null

      اسم القطاع.

    • categoryNameEnstring | null

      اسم القطاع.

    • thumbUrlstring | null

      صورة الشعار المصغرة، WebP بضلع 256. null إن لم يكن للعلامة شعار منشور.

    • isVerifiedboolean

      true حين تكون الجهة موثّقة رسميًا.

    • matchedKindstring | null

      ما طابقه البحث: الاسم العربي أو الإنجليزي، أو اسم بديل، أو اختصار، أو اسم سابق…

      name_arname_enshort_namealias_aralias_enacronymtranslitformer_nameversion_titlekeyword

رموز الحالة

  • 200

    نجح الطلب.

  • 400

    المفتاح في الرابط مرفوض. أرسله في ترويسة Authorization.

    {"error":"key_in_url"}
  • 401

    لا مفتاح في الطلب، والمفتاح مطلوب.

    {"error":"api_key_required"}
  • 401

    المفتاح غير صحيح أو أُلغي.

    {"error":"invalid_api_key"}
  • 403

    حساب المطور موقوف.

    {"error":"account_suspended"}
  • 429

    تجاوزت الحد. انتظر عدد الثواني في Retry-After ثم أعد المحاولة.

    {"items":[],"error":"rate_limited"}

مثال

curl -sS -G 'https://new.wasmenia.com/api/v1/search/suggest' \  -H "Authorization: Bearer $WASMENIA_API_KEY" \  --data-urlencode 'q=الاتصالات'

جرّبها

GET /api/v1/search/suggest?q=الاتصالات

املأ المطلوب ثم أرسل الطلب. الطلب حقيقي، على الأرشيف المنشور.