الانتقال إلى المحتوى الرئيسي
GET
/
tags
/
{tagId}
استرداد تعريف علامة
curl --request GET \
  --url https://api.altostrat.io/tags/{tagId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9",
  "key": "المنطقة",
  "color": "#3F51B5",
  "mandatory_on": [
    "site"
  ],
  "created_at": "2025-10-29T12:00:00Z",
  "updated_at": "2025-10-29T12:30:00Z",
  "values": [
    {
      "tag_id": "tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9",
      "correlation_id": "site_9b52d930f4324c0abac04c12dff85544",
      "correlation_type": "site",
      "value": "APAC",
      "created_at": "2025-10-29T13:00:00Z",
      "updated_at": "2025-10-29T13:00:00Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

tagId
string
required

المعرف الفريد لتعريف العلامة.

Response

تعريف العلامة المطلوب.

id
string

المعرف الفريد لتعريف العلامة.

Example:

"tag_01E8Z4Q6J7B6A5P4E3D2C1B0A9"

key
string

اسم العرض لفئة العلامة (على سبيل المثال، "المنطقة"، "الأولوية").

Example:

"المنطقة"

color
string

رمز لون سداسي عشري يستخدم للعرض في واجهة المستخدم.

Example:

"#3F51B5"

mandatory_on
enum<string>[]

قائمة بأنواع الموارد التي يجب تطبيق هذه العلامة عليها.

created_at
string<date-time>

الطابع الزمني عند إنشاء تعريف العلامة.

Example:

"2025-10-29T12:00:00Z"

updated_at
string<date-time>

الطابع الزمني لآخر تحديث لتعريف العلامة.

Example:

"2025-10-29T12:30:00Z"

values
object[]

قائمة بجميع القيم التي تم تطبيقها باستخدام تعريف العلامة هذا.