مخصّص / متقدّم
للمستخدمين المتقدّمين، أو المتصفّحات المخصّصة، أو أي شيء يقبل عنوان URL خامًّا لمحرّك بحث، إليك قيم Suede الدقيقة.
العنوانان
| الغرض | عنوان URL |
|---|---|
| البحث | https://suede.io/search?q=%s |
| الاقتراحات | https://suede.io/api/autosuggest?q=%s |
%sهي نائب الاستعلام الذي تستخدمه معظم المتصفّحات في مربّع حوار "إضافة محرّك بحث". وبعض المتصفّحات تتوقّع{searchTerms}بدلًا منها (نائب OpenSearch)؛ وكلاهما يشير إلى الشيء نفسه: حيث يذهب استعلامك.- عنوان البحث هو كلّ ما تحتاجه لمحرّك افتراضي أساسي.
- عنوان الاقتراحات اختياري. وهو يعيد OpenSearch Suggestions JSON
(
application/x-suggestions+json) — المصفوفة[query, [completions], [descriptions], [urls]]— كي يستطيع شريط العنوان عرض الإكمالات أثناء كتابتك. ويحسب Suede هذه الاقتراحات بشكل خاصّ، في الذاكرة، من مدوّنته الخاصّة؛ ولا يُحتفظ بسجلّ اقتراحات مرتبط بك.
واصف OpenSearch
إذا كان متصفّحك يقرأ OpenSearch، فوجّهه إلى الواصف فيلتقط كلا العنوانين تلقائيًا:
https://suede.io/opensearch.xmlيُعلَن عن الواصف أيضًا من <head> كلّ صفحة عبر
<link rel="search" …>، فتكتشفه معظم المتصفّحات من تلقاء نفسها — راجع
Android والاكتشاف التلقائي.
البحث بالكلمة المفتاحية / الاختصار
في متصفّح Chromium يمكنك منح Suede اختصارًا (مثل suede). اكتب الاختصار، واضغط Tab أو Space، ثمّ
استعلامك، للبحث في Suede عند الطلب حتى حين لا يكون افتراضيّك. وتأتي إضافات Suede بالكلمة المفتاحية suede مضبوطةً
مسبقًا.
أمثلة سريعة
عنوان URL بحث بسيط (استبدل %s / {searchTerms} باستعلامك المُرمَّز):
https://suede.io/search?q=open+source+searchاجلب اقتراحات لبادئة (يعيد مصفوفة JSON الخاصّة بـOpenSearch):
curl "https://suede.io/api/autosuggest?q=quantum"