الانتقال إلى المحتوى الرئيسي
GET
/
search
البحث في موارد المستأجر
curl --request GET \
  --url https://api.altostrat.io/search \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "doc_1",
      "name": "وثائق مشروع ألفا",
      "type": "document",
      "description": "وثائق شاملة لمشروع ألفا تتضمن مواصفات واجهة برمجة التطبيقات وأدلة المستخدم.",
      "org_id": "org_MyoAolMD2GACSFi8",
      "workspace_id": "ws_sz47boIRd2XfDRk3G0",
      "metadata": {
        "category": "تقني",
        "resource_id": "res_doc_001"
      },
      "created_at": "2025-10-24T12:00:00.000000Z",
      "updated_at": "2025-10-27T15:30:00.000000Z",
      "relevance_percentage": 100,
      "scout_score": 123456789
    }
  ],
  "links": {
    "first": "https://api.altostrat.io/search?page=1",
    "last": "https://api.altostrat.io/search?page=5",
    "prev": null,
    "next": "https://api.altostrat.io/search?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.altostrat.io/search",
    "per_page": 20,
    "to": 20,
    "total": 95
  }
}

Authorizations

Authorization
string
header
required

تستخدم واجهات برمجة تطبيقات Altostrat رموز JWT Bearer للمصادقة.

Query Parameters

q
string
required

سلسلة نصية لاستعلام البحث الأساسي. تقوم الواجهة بإجراء بحث تقريبي مقابل أسماء الموارد وأوصافها وبياناتها الوصفية.

Required string length: 1 - 255
workspace_id
string

عامل تصفية اختياري لتحديد نطاق نتائج البحث لمعرف مساحة عمل معين. إذا تم توفيره، يتم تجاهل org_id. إذا تم حذفه، يعود البحث افتراضيًا إلى نطاق المنظمة.

org_id
string

عامل تصفية اختياري لتحديد نطاق نتائج البحث لمعرف منظمة معين. يستخدم هذا عادةً من قبل المستخدمين الإداريين للبحث خارج منظمتهم الافتراضية. إذا تم حذفه، يتم تحديد نطاق البحث لمنظمة المستخدم المصادق عليه.

types
string[]

مصفوفة من أنواع الكيانات لتصفية النتائج. على سبيل المثال، types[]=device&types[]=policy ستعيد فقط الكيانات من هذين النوعين.

created_from
string<date>

تاريخ البدء لتصفية نطاق تاريخ الإنشاء، بالتنسيق YYYY-MM-DD.

created_to
string<date>

تاريخ الانتهاء لتصفية نطاق تاريخ الإنشاء، بالتنسيق YYYY-MM-DD.

page
integer
default:1

رقم الصفحة لتقسيم النتائج.

Required range: x >= 1
per_page
integer
default:20

عدد النتائج التي سيتم إرجاعها في كل صفحة.

Required range: 1 <= x <= 100

Response

قائمة مقسمة إلى صفحات من نتائج البحث.

data
object[]
meta
object