الانتقال إلى المحتوى الرئيسي
POST
/
metadata
إنشاء كائن بيانات وصفية
curl --request POST \
  --url https://api.altostrat.io/metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "resource_id": "9b52d930-f432-4c0a-bac0-4c12dff85544",
  "type": "mikrotik.device",
  "metadata": {
    "name": "موجه المكتب الرئيسي",
    "location": "الطابق 5، غرفة الخوادم أ",
    "contact_person": "john.doe@example.com"
  }
}'
{
  "resource_id": "9b52d930-f432-4c0a-bac0-4c12dff85544",
  "type": "mikrotik.device",
  "metadata": {
    "circuit_id": "AS12345-XYZ",
    "install_date": "2025-01-15",
    "is_critical": true,
    "rack_units": 2
  }
}

Authorizations

​
Authorization
string
header
required

مطلوب رمز حامل (bearer token) لجميع طلبات واجهة برمجة التطبيقات.

Body

application/json

معرف المورد والبيانات الوصفية لربطها به.

​
resource_id
string<uuid>
required

المعرف العالمي الفريد (UUID) للمورد لربط البيانات الوصفية به.

Example:

"9b52d930-f432-4c0a-bac0-4c12dff85544"

​
type
string
required

سلسلة نصية تحدد نوع المورد.

Example:

"mikrotik.device"

​
metadata
object
required

بيانات المفتاح-القيمة المراد تخزينها. مطلوب مفتاح 'name' عند إنشاء بيانات وصفية جديدة.

Example:
{
  "name": "موجه المكتب الرئيسي",
  "location": "الطابق 5، غرفة الخوادم أ",
  "contact_person": "john.doe@example.com"
}

Response

تم إنشاء أو تحديث البيانات الوصفية بنجاح.

​
resource_id
string<uuid>

المعرف الفريد للمورد الذي تنتمي إليه هذه البيانات الوصفية.

Example:

"9b52d930-f432-4c0a-bac0-4c12dff85544"

​
type
string

سلسلة نصية تحدد نوع المورد.

Example:

"mikrotik.device"

​
metadata
object

كائن حر الشكل يحتوي على أزواج مفتاح-قيمة. يمكن أن تكون القيم سلاسل نصية أو أرقامًا أو قيمًا منطقية.

Example:
{
  "circuit_id": "AS12345-XYZ",
  "install_date": "2025-01-15",
  "is_critical": true,
  "rack_units": 2
}