الإكمال التلقائي: مفاهيم أساسيّة

بعض المعلومات التي يمتلكها خادم تينه (خوادم تينه) مُتاحة للوصول من خلال الاستعلام بالحروف الأولى لهذه المعلومات، و هذا يُعرف أيضاً بالإكمال التلقائي. يُمكن حاليّاً الإكمال التلقائي التخصّصات و كذلك الشركات الخاصّة بالأفراد. دائماً ما يرجع الخادم بالكود 200 و يحوي مصفوفة من الإكمالات التلقائية، و قد يحوي مصفوفةً فارغة []. لطلب الإكمال التلقائي للتخصّصات، اطلب الرابط التالي:

الطلب
GET
{{teenah_api_url}}/majors/autocomplete/{query}
  • {query} الحروف الأولى للتخصّص، مثلاً: (علو).
الرد
200
[
    {
        "id": "1",
        "name": "Computer Science",
        "created_at": "0000-00-00 00:00:00",
        "updated_at": "0000-00-00 00:00:00"
    }
]
  • {id} رقم أو معرّف التخصّص الحاليّ.
  • {name} اسم التخصّص المحدّد.
  • {created_at} تاريخ و وقت إنشاء التخصّص.
  • {updated_at} تاريخ و وقت آخر تحديث لهذا السجل.

و كذلك هناك الإكمال التلقائي للشركات الخاصّة بالأفراد من خلال إرسال طلب GET إلى الرابط التاليّ:

الطلب
GET
{{teenah_api_url}}/companies/autocomplete/{query}
  • {query} الحروف الأولى للشركات مثلاً: (الإ).
الرد
200
[
    {
        "id": "1",
        "name": "Some Company",
        "created_at": "0000-00-00 00:00:00",
        "updated_at": "0000-00-00 00:00:00"
    }
]
  • {id} رقم أو معرّف للشركة الحاليّ.
  • {name} اسم الشركة المحدّد.
  • {created_at} تاريخ و وقت إنشاء هذا السجل.
  • {updated_at} تاريخ و وقت آخر تحديث لهذا السجل.