# الهجرة إلى V1

يشرح هذا الدليل كيفية الترحيل من V0 إلى V1 ، للخدمات الدقيقة المصابة.

# التغييرات عبر الخدمات

# الاستعلام عن العناصر المحذوفة

احصل على نقاط النهاية التي تسمح بإرجاع العناصر المحذوفة الآن للاستعلامات التالية المتاحة:

  • show_active - علامة منطقية (افتراضي true) لإرجاع العناصر غير المحذوفة (أي نشطة) في هيئة الاستجابة
  • show_deleted - علامة منطقية (افتراضي false) لإرجاع العناصر المحذوفة في جسم الاستجابة.

بشكل افتراضي ، سيتم إرجاع العناصر النشطة فقط.

لإرجاع العناصر المحذوفة فقط ، اطلب show_deleted القيمة true و show_active القيمة false.

لإرجاع كل من العناصر النشطة والمحذوفة ، طلب مع show_deleted القيمة true.

ملاحظة: تحتوي بعض نقاط النهاية على استعلام show_deleted فقط ، لكن السلوك هو نفسه.

# ترقيم الصفحات

تمت إضافة ترقيم الصفحات إلى عدة طرق عبر الخدمات. هذه الردود الكبيرة يمكن إدارتها بشكل معقول.

يضيف ترقيم الصفحات استفسارات جديدة إلى أي نقاط نهاية متصفح:

+ ?page_limit=int
+ ?before=base64
+ ?after=base64

في حالة عدم وجودها من قبل ، ستكون الاستفسارات الجديدة لـ order و sort_by موجودة أيضًا على نقاط النهاية المخلوطة:

+ ?sort_by=name
+ ?order=desc

يرجى الاطلاع على الوثائق لمزيد من المعلومات حول هذه الاستفسارات.

كما تم تحديث هيئات الاستجابة لنقاط النهاية المصبوبة بمفاتيح جديدة:

+ paging: {
+     cursors: {
+       before: "MjUxYjYzNzAtNDk1MC1lNzExLTgxMDQtMDA1MDU2YjU3NDU5",
+       after: "OGExMTcxNzAtNDk1MC1lNzExLTgxMDQtMDA1MDU2YjU3NDU5"
+     },
+     previous: "http://ddb.arup.com/api/projects?before=MjUxYjYzNzAtNDk1MC1lNzExLTgxMDQtMDA1MDU2YjU3NDU5",
+     next: "http://ddb.arup.com/api/projects?after=MjUxYjYzNzAtNDk1MC1lNzExLTgxMDQtMDA1MDU2YjU3NDU5"
+   },
+   summary: {
+     estimate_count: 44
+  }

# رسائل خاطئة

لم تعد ردود خطأ العميل تتضمن مفتاح source:

  {
    details: "id \"632f6133-c5c4-4232-bdb6-c1a227a48b8e\" could not be found",
    msg: "Route Not Found",
-   source: "body"
  }

# خدمة المعلمة

يرجى استخدام ملاحظات الترحيل هذه للمساعدة في التبديل من V0 من parameter-service-api إلى V1. يجب على هذا القسم تفصيل جميع التغييرات عبر الإصدارات.

# نقاط النهاية المنهكة

تمت إزالة نقاط النهاية التالية من V1:

# GET /parameters/:parameter_id/revision

تم استبداله بنقطة نهاية جديدة GET /entries/:entry_id/revisions (انظر أدناه)

# POST /parameters/:parameter_id/revision

تم استبداله بنقطة نهاية جديدة PUT /entries (انظر أدناه)

# PATCH /parameters/:parameter_id/revision

تم استبداله بنقطة نهاية جديدة PATCH /revisions (انظر أدناه)

# التغييرات عبر نقاط النهاية

يرجى الاطلاع أدناه للحصول على التغييرات على كل نقطة نهاية. هذا منظم بطريقة مماثلة ل وثائق API (opens new window) لسهولة الاستخدام.

ملاحظة: ليس كل نقاط النهاية لديها تغييرات.

# أصول

# GET /assets

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.
  • يتضمن هيئة الاستجابة الآن خاصية asset_type_id في مفتاح asset_sub_type:
asset_sub_type: {
id: "a7154e9a-9dd4-4983-a900-c172a3366544",
name: "Domestic Hot Water",
* asset_type_id: "577cfd8d-8da0-4d78-b4a4-c81ab728d4bf",
parent_asset_sub_type_id: "f2ac4d11-6854-4763-b26e-2b2c664390cb"
}
  • تم استبدال استعلام show_deleted_assets. لطفا أنظر القسم أعلاه للمزيد من المعلومات
* GET /assets?show_deleted_assets=true
* GET /assets?show_deleted=true

# POST /assets

  • تقبل نقطة النهاية هذه الآن واحدة من asset_type_id أو asset_sub_type_id في جسم الطلب:
  • إذا كنت توفر asset_sub_type_id ، فإن الحقل name اختياري وإذا كان ترك فارغًا يتم ملؤه تلقائيًا لمطابقة اسم asset_sub_type.
  • إذا قمت بتقديم asset_type_id فقط لأصل يحتوي على خاصية asset_sub_type من true ، ستتلقى خطأ في حالة نشرها مع خاصية name لا تتطابق مع أحد الأسماء الفرعية الصالحة.
  • يتضمن هيئة الاستجابة الآن الخاصية asset_type_id في مفتاح asset_sub_type:
asset_sub_type: {
id: "a7154e9a-9dd4-4983-a900-c172a3366544",
name: "Domestic Hot Water",
* asset_type_id: "577cfd8d-8da0-4d78-b4a4-c81ab728d4bf",
parent_asset_sub_type_id: "f2ac4d11-6854-4763-b26e-2b2c664390cb"
}

# GET /assets/{asset_id}

  • يتضمن هيئة الاستجابة الآن الخاصية asset_type_id في مفتاح asset_sub_type:

    asset_sub_type: {
          id: "a7154e9a-9dd4-4983-a900-c172a3366544",
          name: "Domestic Hot Water",
    +     asset_type_id: "577cfd8d-8da0-4d78-b4a4-c81ab728d4bf",
          parent_asset_sub_type_id: "f2ac4d11-6854-4763-b26e-2b2c664390cb"
        }
    
  • تم استبدال استعلام show_deleted_assets. الرجاء مراجعة القسم أعلاه للمزيد من المعلومات

* GET /assets?show_deleted_assets=true
* GET /assets?show_deleted=true

# GET /assets/{asset_ids}/hierarchy

  • يتضمن كل كائن hierarchy في هيئة الاستجابة الآن مفتاح asset_type_id:

    {
      hierarchies: [
        [
          {
            id: "a3d5c386-9451-495e-9d3c-8ed152b1300f",
            name: "Wellington Place",
    +       asset_type_id: "a3d5c386-9451-495e-9d3c-8ed152b1300f"
          }
        ]
      ]
    }
    

# إدخالات

يمثل الإدخال قيمة للمعلمة. يمكن مراجعة الإدخالات. حاليا ، تقتصر المعلمات على إدخال واحد كحد أقصى. في الإصدارات المستقبلية ، سيكون لدى المعلمات القدرة على الحصول على إدخالات متعددة. الرجاء مراجعة توثيق (opens new window) للمزيد من المعلومات.

هناك أربعة طرق جديدة تتعلق بالإدخالات:

# GET /entries

  • تُرجع نقطة النهاية هذه جميع الإدخالات ، وهذا أمر قابل للاستعلام بواسطة مجموعة من parameter_id.

# PUT /entries

  • تستبدل نقطة النهاية هذه POST /parameters/:parameter_id/revision وتتيح لك إنشاء أو تحديث إدخالات واحدة أو أكثر.
  • تقبل نقطة النهاية هذه مجموعة من entries. الحقول المطلوبة هي entry_id ، parameter_id ، source_id ، values. حاليا ، values لديه طول أقصى قدره. الإضافات الاختيارية هي comment و location_in_source.

# GET /entries/:entry_id/revisions

  • تستبدل نقطة النهاية هذه GET /parameters/:parameter_id/revision ، وتُرجع جميع المراجعات لـ entry_id.

# PATCH /revisions

  • تستبدل نقطة النهاية هذه نقطة النهاية PATCH /parameters/:parameter_id/revisions وتسمح للمستخدمين بتحديث status من مراجعات متعددة تتعلق بإدخالات مختلفة متعددة في وقت واحد.
  • يجب على المستخدمين فقط تحديثأحدثمراجعة دخول
  • يتعين على المستخدمين تحديد revision_id من المراجعة للتحديث
  • إذا قام المستخدمون بتحديث المراجعة status إلى QA State rejected a comment الخاصية مطلوب.

# مجموعات المعلمة

ملاحظة: مجموعات المعلمات في إصدار ألفا للاختبار. لا ينصح باستخدام هذه الطرق في الإنتاج.

تم تغيير اتفاقيات التسمية لمجموعات المعلمات من V0 إلى V1. التغييرات كما يلي:

V0 اتفاقية تسمية V1 اتفاقية تسمية
parameter_set_type parameter_set_category
parameter_set parameter_set_type
parameter_set_instance parameter_set

وقد أدى ذلك إلى تحديث الطرق بالطريقة التالية:

V0 طريق طريق V1
GET /parameter_set_types GET /parameter_set_categories
GET /parameter_sets GET /parameter_set_types
POST /parameter_sets POST /parameter_set_types
DELETE /parameter_sets/:parameter_set_id DELETE /parameter_set_types/:parameter_set_type_id
POST /parameter_sets/:parameter_set_id/items POST /parameter_set_types/:parameter_set_type_id/items
DELETE //parameter_sets/:parameter_set_id/items/:item_type_id DELETE /parameter_set_types/:parameter_set_type_id/items/:item_type_id
GET /parameter_sets/:parameter_set_id/instances GET /parameter_sets
GET /parameter_sets/:parameter_set_id/instances/:instance_id GET /parameter_sets/:parameter_set_id
GET /parameter_sets/:parameter_set_id/instances/:instance_id/parameters GET /parameter_sets/:parameter_set_id/parameters

تم تحديث المفاتيح على هيئات الاستجابة بالطريقة ذات الصلة. على سبيل المثال ، طلب إلى GET /parameter_set_categories (المعروف سابقًا باسم GET /parameter_set_types) سيعيد استجابة بـ:

{
- parameter_set_types: [ ... ]
+ parameter_set_categories: [ ... ]
}

يجب أن تتصرف جميع نقاط النهاية بطريقة مماثلة (باستثناء نقاط النهاية المفصلة أدناه).

# GET /parameter_sets

تحل نقطة النهاية هذه محل V0 endpoint GET /parameter_sets/:parameter_set_id/instances. لتصفية مجموعات المعلمة بواسطة parameter_set_type_id يتم تمرير هذا من خلال استعلام في نقطة النهاية:

+ GET /parameter_sets?parameter_set_type_id=uuid

سيؤدي ذلك إلى إرجاع كل parameter_sets من parameter_set_type_id المحدد.

# GET /parameter_sets/:parameter_set_id/parameters

تحتوي نقطة النهاية هذه على استجابة مخفضة مقارنة بإصدار V0 (GET /parameter_sets/:parameter_set_id/instances/:instance_id/parameters):

{
- parameter_set_instance_parameters: [
+ parameter_set_parameters: [
 {
 ...parameter,
 parameter_type: {
 id,
 name,
 data_type,
 global_parameter,
- unit_type_id,
- created_at,
- deleted_at,
- updated_at
 },
 parents: [
 {
 id,
 asset_sub_type,
 children,
 name,
 parent,
 asset_type: {
 id,
 name,
 parent_id,
- asset_sub_type,
- asset_type_group,
- created_at,
- deleted_at,
 },
- project_id,
- deleted_at,
 }
 ]
 }
 ],
 ... rest
}


# حدود

# GET /parameters

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

  • تم استبدال استعلام show_deleted_parameters. الرجاء مراجعة القسم أعلاه للمزيد من المعلومات

    - GET /parameters?show_deleted_parameters=true
    + GET /assets?show_deleted=true
    
  • تمت إزالة استعلام offset:

    - GET /parameters?offset=
    
  • تمت إعادة تسمية مفتاح revision في جسم الاستجابة إلى selected_entry:

    {
      parameters: [
        {
          ... parameter,
    -    revision: { ... }
    +     selected_entry: { ... }
        },
        ...
      ]
    }
    
    
  • يحتوي مفتاح selected_entry.source على استجابة مخفضة

    source: {
              id: "286a550e-00bc-4b1e-8e20-71f96b43e9c6",
              created_at: "2022-07-18T16:00:53.182Z",
    -         updated_at: "2022-07-18T16:00:53.182Z",
    -         deleted_at: null,
    -         time: null,
              date_day: "15",
              date_month: "1",
              date_year: "2021",
              reference: "Assumption",
    -         reference_id: "90803033-268a-ea11-8129-005056b50c57",
    -         reference_table: "project",
    -         reference_url: "dev.ddb.arup.com/api/project",
    -         scope: "90803033-268a-ea11-8129-005056b50c57",
              title: "Assumption",
              url: "TBA",
              source_type: {
                id: "6a1292c7-a245-41cf-8872-46feb9a7fd11",
                name: "Assumption",
    -           visible: true,
    -           deleted_at: null
              }
            }
    
  • يحتوي مفتاح selected_entry.created_by على استجابة مخفضة

    created_by: {
    -         staff_id: 12345,
              staff_name: "Arup Employee Name",
              email: "[email protected]",
    -         company_centre_arup_unit: "01-462 NOR Digital Services",
    -         location_name: "Edinburgh Office",
    -         grade_level: 3,
    -         my_people_page_url: "https://arup-my.sharepoint.com/PersonImmersive.aspx?accountname=i:0%83.f%7cmembership%[email protected]"
    },
    
  • لا يحتوي مفتاح selected_entry على updated_at أو comment أو location_in_source.

# POST /parameters

  • تم استبدال مفتاح revision في جسم الطلب بـ entries ، الذي يقبل مجموعة.
  • يوجد مفتاح اختياري entry_id في entries post body:
    • إذا كنت تضيف إدخالًا جديدًا إلىدون إجابةالمعلمة ، يمكن ترك هذا فارغًا وسيتم ملءه تلقائيًا باستخدام UUID جديد.
    • إذا كنت ترغب في مراجعةأجابالمعلمة ، يجب عليك توفير entry_id الحالي للمراجعة.

يقتصر هذا حاليًا على عنصر واحد في خاصية entries فقط.

  • يتم الآن إعادة تسمية مفتاح revision
- revision: { ... }
+ selected_entry: { ... }

# selected_entry

  • تم استبدال استعلام GET /parameters/{parameter_id}. الرجاء مراجعة القسم أعلاه للمزيد من المعلومات

    - GET /parameters/:parameter_id?show_deleted_parameters=true
    + GET /parameters/:parameter_id?show_deleted=true
    
  • تمت إعادة تسمية مفتاح show_deleted_parameters في هيئة الاستجابة إلى revision

    - revision: { ... }
    + selected_entry: { ... }
    
  • يحتوي مفتاح selected_entry على استجابة مخفضة

    source: {
              id: "286a550e-00bc-4b1e-8e20-71f96b43e9c6",
              created_at: "2022-07-18T16:00:53.182Z",
    -         updated_at: "2022-07-18T16:00:53.182Z",
    -         deleted_at: null,
    -         time: null,
              date_day: "15",
              date_month: "1",
              date_year: "2021",
              reference: "Assumption",
    -         reference_id: "90803033-268a-ea11-8129-005056b50c57",
    -         reference_table: "project",
    -         reference_url: "dev.ddb.arup.com/api/project",
    -         scope: "90803033-268a-ea11-8129-005056b50c57",
              title: "Assumption",
              url: "TBA",
              source_type: {
                id: "6a1292c7-a245-41cf-8872-46feb9a7fd11",
                name: "Assumption",
    -           visible: true,
    -           deleted_at: null
              }
            }
    
  • يحتوي مفتاح selected_entry.source على استجابة مخفضة

    created_by: {
    -         staff_id: 12345,
              staff_name: "Arup Employee Name",
              email: "[email protected]",
    -         company_centre_arup_unit: "01-462 NOR Digital Services",
    -         location_name: "Edinburgh Office",
    -         grade_level: 3,
    -         my_people_page_url: "https://arup-my.sharepoint.com/PersonImmersive.aspx?accountname=i:0%83.f%7cmembership%[email protected]"
    },
    
  • لا يحتوي مفتاح selected_entry.created_by على selected_entry أو updated_at أو comment.

# شجرة

هناك العديد من نقطة النهاية الجديدة لإرجاع التسلسلات الهرمية للشجرة. الرجاء مراجعة توثيق (opens new window) لمزيد من المعلومات حول نقاط النهاية هذه.

# location_in_source

  • نقطة نهاية جديدة تُرجع شجرة الأصول بواسطة GET /asset_tree.

# asset_id

  • نقطة نهاية جديدة تُرجع شجرة نوع الأصول بواسطة GET /asset_type_tree.

# الأنواع

# asset_type_id

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

# GET /asset_type_groups

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

# GET /asset_types

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

# GET /asset_types/{asset_type_id}/asset_sub_types

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

  • تمت إعادة تسمية مفتاح GET /parameter_types على الخاصية name في هيئة الاستجابة إلى default_unit:

    default_unit: {
          id: "b39e5bcf-cda6-49ed-8c0c-174d8daf8bc1",
    -     name: "°C",
    +     symbol: "°C",
          unit_type_id: "5391cd71-08f0-44f8-9dd2-6379a511dd29",
          unit_system_id: "50115948-140f-48fc-b5f2-c56e96869734"
          }
    

# symbol

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.
  • تمت إزالة استعلام GET /item_types.

# offset

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

  • يحتوي كل كائن GET /unit_types على مفتاح جديد unit_type ، يحتوي

    unit_types: [
    {
    id: "e8c3da00-5c20-45f1-a24c-0d657bcae032",
    name: "Geotechnics analysis material type",
    created_at: "2022-06-24T12:26:00.263Z",
    updated_at: "2022-06-24T12:26:00.263Z",
    deleted_at: null,
    + unit_systems: [
    +  {
    +    id: "5508a780-9f9f-4e6d-bc9c-a84607a5ba87",
    +    name: "Drop-down list",
    +    short_name: "Drop-down",
    +    units: [
    +      {
    +        id: "892c32c1-808a-440a-8290-e05fdf5457ba",
    +        symbol: "Mohr-coulomb, linear-elastic"
    +      }
    +    ]
    +  }
    + ]
    }
    ]
    

# unit_systems

  • تم تحديث هيئة الاستجابة POST /unit_types لطريقة النشر بنفس طريقة unit_types - يرجى الرجوع إلى هذا القسم للحصول على التفاصيل.

# GET /unit_types

  • يتضمن جسم استجابة الكائن GET /unit_types/:unit_type_id unit_type و created_at و updated_at مفاتيح:
unit_type: {
 id: "38f045f3-ce7a-4a38-9fe7-f9d72d07a129",
 name: "Area",
+ created_at: "2021-12-22T13:07:17.214Z",
+ updated_at: "2021-12-22T13:07:17.214Z",
+ deleted_at: null,
 unit_systems: [ ... ]
 }

# الوحدات

# deleted_at

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

  • تمت إعادة تسمية مفتاح GET /units في جسم الاستجابة إلى name:

    {
      id: "a3d5c386-9451-495e-9d3c-8ed152b1300f",
      created_at: "2019-05-10T13:45:08.000Z",
      deleted_at: "2020-06-18T11:25:21.000Z",
    - name: "m",
    + symbol: "m",
      updated_at: "2020-06-12T13:39:41.000Z",
      unit_type_id: "7a857f03-a222-405c-bc03-90d6dcaa8e0e",
      unit_system_id: "50115948-140f-48fc-b5f2-c56e96869734"
    }
    

# symbol

  • لم يعد هيئة الطلب يقبل حقل POST /units. يجب أن يكون هذا الآن name:

    {
      id: "cdbcb4d1-b6c1-436c-8126-737c29c9b2f4",
    - name: "°F",
    + symbol: "°F",
      unit_type_id: "b68caf97-e537-4ce4-b3bd-7131f0e72e93",
      unit_system_id: "50115948-140f-48fc-b5f2-c56e96869734"
      }
    

# symbol

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.

# خدمة بيانات التعريف

يرجى استخدام ملاحظات الترحيل هذه للمساعدة في التبديل من V0 من GET /unit_systems إلى V1. يجب أن يشرح هذا المستند جميع التغييرات عبر الإصدارات.

# نقاط النهاية المنهكة

يرجى ملاحظة أنه يتم إهمال جميع نقاط النهاية في V0 من واجهة برمجة التطبيقات (API

# التغييرات عبر نقاط النهاية

يرجى الاطلاع أدناه للحصول على التغييرات على كل نقطة نهاية. هذا منظم بطريقة مماثلة ل وثائق API (opens new window) لسهولة الاستخدام.

ملاحظة: ليس كل نقاط النهاية لديها تغييرات.

# parameter-metadata-service-api

  • Allow Custom هو مفتاح جديد في هيئة الاستجابة لجميع كائنات allow_custom التي تم إرجاعها. تشير هذه الخاصية إلى ما إذا كان tag_type يقبل العلامات المخصصة أو عدم استخدام قيمة منطقية لـ tag_type أو true.

    tag_type: {
            id: "1e08965a-f116-4a6d-8bba-74290edc8c0a",
            created_at: "2019-05-10T13:45:08.000Z",
            deleted_at: "2019-05-10T13:45:08.000Z",
            name: "Calculation",
            updated_at: "2019-05-10T13:45:08.000Z",
    +       allow_custom: false
          }
    

# بطاقة شعار

# false

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.
  • تم إضافة استفسارات جديدة لاسترداد العلامات المحذوفة. لطفا أنظر القسم أعلاه للمزيد من المعلومات.
  • تم استبدال استعلام GET /tags باستعلام item_limit كجزء من ترقيم الصفحات.
  • هناك استعلام جديد متاح لـ page_limit ، يمكن أن يكون هذا واحدًا أو أكثر tag_scope وسيعيد جميع العلامات باستخدام project_id. فارغة (tag_scope) مرشحات سلسلة الاستعلام لجميع العلامات بدون نطاق ، أي العلامات العالمية.
  • هناك استعلام جديد متاح لـ null (Bool). إذا كان هذا صحيحًا ، فهذا يحذف جميع العلامات العالمية (تلك التي تحتوي على omit_global) من النتيجة. القيمة الافتراضية لهذا الاستعلام هي tag_scope = null.
  • يتضمن الكائن false في هيئة الاستجابة لـ tag_type مفتاحًا جديدًا لـ tag. لطفا أنظر هذا القسم للمزيد من المعلومات.

# allow_custom

  • هذه نقطة نهاية جديدة تتيح للمستخدمين إضافة علامة جديدة.
  • يمكن لأي مستخدم نشر علامة مخصصة يتم تحديدها إلى مشروع (أي علامة تحتوي على POST /tags مع خاصية tag_type و allow_custom: true). يتطلب نشر العلامات العالمية امتيازات المسؤول.

# tag_scope: your-project-uuid

  • يتضمن كائن GET /tags/:tag_id في هيئة الاستجابة الآن مفتاحًا جديدًا لـ tag_type. لطفا أنظر هذا القسم للمزيد من المعلومات.

# allow_custom

  • هذه نقطة نهاية جديدة تتيح لك تحديث خاصية علامة PATCH /tags/:tag_id.
  • تتطلب نقطة النهاية هذه امتيازات المسؤول.

# name

  • هذه نقطة نهاية جديدة تتيح لك حذف علامة بواسطة DELETE /tags/:tag_id.
  • تتطلب نقطة النهاية هذه امتيازات المسؤول.

# روابط العلامات

# tag_id

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.
  • تم إضافة استفسارات جديدة لاسترداد روابط العلامات المحذوفة. لطفا أنظر القسم أعلاه للمزيد من المعلومات.
  • هذه نقطة نهاية جديدة للمستخدمين للحصول على رابط علامة موجود بين الموارد.
  • هذه نقطة نهاية جديدة لتحديث الروابط PATCH /tags/{tag_id}/links/{reference_id} و/أو reference_table بين علامة ومرجع.

# reference_url

  • هذه نقطة نهاية جديدة تتيح للمستخدمين وضع جديد و/أو تحديث PUT /tag_links.

# نوع العلامة

  • وأضاف ترقيم الصفحات. الرجاء مراجعة قسم البدء للمزيد من المعلومات.
  • تم إضافة استفسارات جديدة لاسترداد أنواع العلامات المحذوفة. لطفا أنظر القسم أعلاه للمزيد من المعلومات.
  • تتضمن الكائنات GET /tag_types في هيئة الاستجابة الآن مفتاحًا جديدًا لـ tag_type. لطفا أنظر هذا القسم للمزيد من المعلومات.

# allow_custom

  • هذه نقطة نهاية جديدة تتيح لك إضافة POST /tag_types tag_type
  • تتطلب نقطة النهاية هذه امتيازات المسؤول.

# GET /tag_types/:tag_type_id

  • يتضمن كائن tag_type في هيئة الاستجابة الآن مفتاحًا جديدًا لـ allow_custom. لطفا أنظر هذا القسم للمزيد من المعلومات.

# PATCH /tag_types/{tag_type_id}

  • هذه نقطة نهاية جديدة تتيح للمستخدمين تحديثات tag_type.

*ملاحظة: تتطلب نقطة النهاية امتيازات المسؤول. *

# DELETE /tag_types/{tag_type_id}
  • نقطة نهاية جديدة تحذف نوع علامة واحد باستخدام tag_type_id كاستعلام مطلوب
  • تتطلب نقطة النهاية هذه امتيازات المسؤول.

# خدمة سياق البيئة

يرجى استخدام ملاحظات الترحيل هذه للمساعدة في التبديل من V0 من Environmental-Context-Service-api إلى V1. يجب أن يشرح هذا المستند جميع التغييرات عبر الإصدارات.

# نقاط النهاية المنهكة

يرجى ملاحظة أن جميع نقاط النهاية في V0 من API يتم إهمالها لذلك يجب على المستخدمين الترقية إلى الإصدار التالي المتاح

Last Updated: ٢١‏/٦‏/٢٠٢٤, ١١:٣٤:٤٤ ص