V1'e geçiş

Bu kılavuz, etkilenen mikro hizmetler için V0'dan V1'e nasıl geçileceğini açıklar.

Hizmetler genelinde değişiklikler

Silinen öğeler için sorgulama

Silinmiş ürünlerin iade edilmesine izin veren uç noktalar alın aşağıdaki sorgulara sahiptir:

• show_active - Yanıt gövdesindeki silinmemiş (yani etkin) öğeleri döndürmek için bir boole bayrağı (varsayılan true)

• show_deleted - Yanıt gövdesindeki silinen öğeleri iade etmek için bir Boolean bayrağı (varsayılan false).

Varsayılan olarak, aktif öğeler yalnızca döndürülecektir.

Yalnızca silinen öğeleri döndürmek için show_deleted değeri true ve show_active değeri false ile istek.

Hem aktif hem de silinmiş öğeleri döndürmek için show_deleted değeri true ile istek.

Not: Bazı uç noktalar yalnızca show_deleted sorgusunu içerir, ancak davranış aynıdır.

Toplama

Hizmetlerdeki çeşitli yollara sayfa eklenmiştir. Bu çok büyük yanıtlar makul bir şekilde yönetilebilir.

Pagination, arınmış uç noktalara yeni sorgular ekler:

+ ?page_limit=int

+ ?before=base64

+ ?after=base64

Daha önce mevcut olmadığında, order ve sort_by yeni sorguları da arındırılmış uç noktalarda bulunacaktır:

+ ?sort_by=name

+ ?order=desc

Bu sorgular hakkında daha fazla bilgi için lütfen belgelere bakın.

Ölçeklendirilmiş uç noktalar için yanıt gövdeleri de yeni anahtarlarla güncellendi:

+ 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

+ }

Hata mesajları

İstemci hata yanıtları artık source tuşunu içermiyor:

  {

    details: "id \"632f6133-c5c4-4232-bdb6-c1a227a48b8e\" could not be found",

    msg: "Route Not Found",

-   source: "body"

  }

Parametre hizmeti

Lütfen parameter-service-api V0'dan V1'e geçmeye yardımcı olmak için bu geçiş notlarını kullanın. Bu bölüm sürümlerdeki tüm değişiklikleri detaylandırmalıdır.

Kullanımdan kaldırılmış uç noktalar

Aşağıdaki uç noktalar V1'den kaldırıldı:

**GET /parameters/:parameter_id/revision**

Yeni uç nokta GET /entries/:entry_id/revisions ile değiştirildi (aşağıya bakın)

**POST /parameters/:parameter_id/revision**

Yeni uç nokta PUT /entries ile değiştirildi (aşağıya bakın)

**PATCH /parameters/:parameter_id/revision**

Yeni uç nokta PATCH /revisions (aşağıya bakın)

Uç noktalardaki değişiklikler

Her uç noktadaki değişiklikler için lütfen aşağıya bakın. Bu benzer şekilde yapılandırılmıştır API belgeleri (opens new window) kullanım kolaylığı için.

Not: Tüm uç noktaların değişiklikleri olmadı.

Varlıklar

GET /assets

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Yanıt gövdesi artık asset_type_id tuşunda asset_sub_type özelliği içeriyor:

  
  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 sorgusu değiştirildi. Bakınız Bölümün üstünde daha fazla bilgi için

  
  - GET /assets?show_deleted_assets=true
  
  + GET /assets?show_deleted=true
  
  

POST /assets

• Bu uç nokta artık istek gövdesinde asset_type_id veya asset_sub_type_id'dan birini kabul ediyor:

• asset_sub_type_id sağlıyorsanız, name alanı isteğe bağlıdır ve boş bırakılırsa asset_sub_type adına eşleşecek şekilde otomatik olarak doldurulur.

• Bir asset_type_id asset_sub_type özelliğine sahip bir varlık için true sağlarsanız, geçerli alt tür adlarından biriyle eşleşmeyen bir name özelliği ile gönderiyorsanız bir hata alırsınız.

• Yanıt gövdesi artık asset_type_id tuşunda asset_sub_type özelliği içeriyor:

  
  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}

• Yanıt gövdesi artık asset_type_id tuşunda asset_sub_type özelliği içeriyor:

  
  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 sorgusu değiştirildi. Lütfen bkz Bölümün üstünde daha fazla bilgi için

  
  - GET /assets?show_deleted_assets=true
  
  + GET /assets?show_deleted=true
  
  

GET /assets/{asset_ids}/hierarchy

• Yanıt gövdesindeki her hierarchy nesnesi artık bir asset_type_id anahtarı içeriyor:

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

Girdileri

Giriş bir parametre için bir değeri temsil eder. Girişler revize edilebilir. Şu anda, parametreler maksimum bir girişle sınırlıdır. Gelecek sürümlerde, parametreler birden fazla girişe sahip olacak. Lütfen bkz belgeler (opens new window) daha fazla bilgi için.

Girişlerle ilgili dört yeni rota vardır:

GET /entries

• Bu uç nokta tüm girişleri döndürür, bu parameter_id 'lık bir dizi tarafından sorgulanabilir.

PUT /entries

• Bu uç nokta POST /parameters/:parameter_id/revision'ın yerini alır ve bir veya daha fazla giriş oluşturmanıza veya güncellemenize olanak tanır.

• Bu uç nokta bir entries dizisini kabul eder. Gerekli alanlar entry_id, parameter_id, source_id, values'dır. Şu anda, values maksimum bir uzunluğa sahiptir. İsteğe bağlı eklemeler comment ve location_in_source'dır.

GET /entries/:entry_id/revisions

• Bu uç nokta GET /parameters/:parameter_id/revision'ın yerini alır ve belirli bir entry_id için tüm revizyonları döndürür.

PATCH /revisions

• Bu uç nokta PATCH /parameters/:parameter_id/revisions uç noktasının yerini alır ve kullanıcıların aynı anda birden fazla farklı girişle ilgili birden fazla revizyonun status'ini güncellemesine olanak tanır.

• Kullanıcılar yalnızca güncellemelidiren sonuncuBir girişin revizyonu

• Kullanıcıların güncellenmesi için revizyonun revision_id'ı belirtmeleri gerekmektedir.

• Kullanıcılar status revizyonunu QA State rejected olarak güncelliyorsa, comment özelliği gereklidir.

Parametre setleri

Not: Parametre setleri test için alfa sürümünde. Bu rotaların üretimde kullanılması önerilmez.

Parametre kümeleri için adlandırma kuralları V0'dan V1'e değiştirildi. Değişiklikler aşağıdaki gibidir:

| V0 Adlandırma Sözleşmesi | V1 Adlandırma Sözleşmesi |

| ------------------------ | ------------------------ |

| parameter_set_type | parameter_set_category |

| parameter_set | parameter_set_type |

| parameter_set_instance | parameter_set |

Bu, rotaların şu şekilde güncellenmesine neden oldu:

| V0 Rotası | V1 rotası |

| ------------------------------------------------------------------------- | ------------------------------------------------------------------------ |

| 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 |

Yanıt gövdelerindeki anahtarlar ilgili şekilde güncellendi. Örneğin, GET /parameter_set_categories (daha önce GET /parameter_set_types olarak bilinir) talebi aşağıdakilerle yanıt döndürür:

{

- parameter_set_types: [ ... ]

+ parameter_set_categories: [ ... ]

}

Tüm uç noktalar benzer şekilde davranmalıdır (aşağıda detaylandırılmış uç noktalar hariç).

GET /parameter_sets

Bu uç nokta V0 uç noktası GET /parameter_sets/:parameter_set_id/instances'ın yerini alır. Parametre setlerini ilgili parameter_set_type_id ile filtrelemek için bu, uç noktadaki bir sorgudan geçirilir:

+ GET /parameter_sets?parameter_set_type_id=uuid

Bu, belirtilen parameter_sets'ın tüm parameter_set_type_id'ı döndürür.

GET /parameter_sets/:parameter_set_id/parameters

Bu uç nokta, V0 sürümüne (GET /parameter_sets/:parameter_set_id/instances/:instance_id/parameters) kıyasla düşük bir yanıt içerir:

{

- 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

}

Parametreler

GET /parameters

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• show_deleted_parameters sorgusu değiştirildi. Lütfen bkz Bölümün üstünde daha fazla bilgi için

  
  - GET /parameters?show_deleted_parameters=true
  
  + GET /assets?show_deleted=true
  
  

• offset sorgusu kaldırıldı:

  
  - GET /parameters?offset=
  
  

• Yanıt gövdesindeki revision anahtarı selected_entry olarak yeniden adlandırıldı:

  
  {
  
    parameters: [
  
      {
  
        ... parameter,
  
  -    revision: { ... }
  
  +     selected_entry: { ... }
  
      },
  
      ...
  
    ]
  
  }
  
  

• selected_entry.source anahtarı azaltılmış bir yanıt içerir

  
  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 anahtarı azaltılmış bir yanıt içerir

  
  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 tuşunda updated_at, comment veya location_in_source özelliği yoktur.

POST /parameters

• İstek gövdesindeki revision anahtarı, bir diziyi kabul eden entries ile değiştirildi.

• entry_id Post gövdesinde isteğe bağlı bir entries anahtarı vardır:

• Bir yeni giriş ekliyorsanızcevapsızParametre, bu boş bırakılabilir ve otomatik olarak yeni bir UUID ile doldurulur.

• BircevaplanmışParametre, revize etmek için mevcut entry_id sağlamalısınız.

Bu şu anda yalnızca entries özelliğindeki bir öğe ile sınırlıdır.

• Post yanıt gövdesindeki revision anahtarı artık selected_entry olarak yeniden adlandırıldı.

  
  - revision: { ... }
  
  + selected_entry: { ... }
  
  

GET /parameters/{parameter_id}

• show_deleted_parameters sorgusu değiştirildi. Lütfen bkz Bölümün üstünde daha fazla bilgi için

  
  - GET /parameters/:parameter_id?show_deleted_parameters=true
  
  + GET /parameters/:parameter_id?show_deleted=true
  
  

• Yanıt gövdesindeki revision anahtarı selected_entry olarak yeniden adlandırıldı.

  
  - revision: { ... }
  
  + selected_entry: { ... }
  
  

• selected_entry.source tuşu azaltılmış bir yanıt içerir

  
  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 anahtarı azaltılmış bir yanıt içerir

  
  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 tuşunda updated_at, comment veya location_in_source özelliği yoktur.

Ağaç

Ağaç hiyerarşilerini geri döndürmek için birkaç yeni uç nokta vardır. Lütfen bkz belgeler (opens new window) Bu uç noktalar hakkında daha fazla bilgi için.

GET /asset_tree

• Bir varlık ağacını asset_id döndüren yeni uç nokta.

GET /asset_type_tree

• Bir varlık türü ağacı asset_type_id döndüren yeni uç nokta.

Türler

GET /asset_type_groups

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

GET /asset_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

GET /asset_types/{asset_type_id}/asset_sub_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

GET /parameter_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Yanıt gövdesindeki name özelliğindeki default_unit anahtarı symbol olarak yeniden adlandırıldı:

  
  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"
  
        }
  
  

GET /item_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• offset sorgusu kaldırıldı.

GET /unit_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Her unit_type nesnesinin, belirli bir tür için mevcut olan birim sistemleri ve birimleri içeren yeni bir unit_systems tuşu vardır.

  
  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"
  
  +      }
  
  +    ]
  
  +  }
  
  + ]
  
  }
  
  ]
  
  

POST /unit_types

• Post yöntemi için unit_types yanıt gövdesi GET /unit_types ile aynı şekilde güncellenmiştir - ayrıntılar için lütfen bu bölüme bakın.

GET /unit_types/:unit_type_id

• unit_type nesne yanıt gövdesi artık created_at, updated_at ve deleted_at tuşlarını içeriyor:

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: [ ... ]

 }

Birimler

GET /units

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Yanıt gövdesindeki name anahtarı symbol olarak yeniden adlandırıldı:

  
  {
  
    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"
  
  }
  
  

POST /units

• İstek gövdesi artık bir name alanını kabul etmiyor. Bu şimdi symbol olmalı:

  
  {
  
    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"
  
    }
  
  

GET /unit_systems

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

Parametre Meta Veri Hizmeti

Lütfen parameter-metadata-service-api V0'dan V1'e geçmeye yardımcı olmak için bu geçiş notlarını kullanın. Bu belge, sürümlerdeki tüm değişiklikleri detaylandırmalıdır.

Kullanımdan kaldırılmış uç noktalar

API'nın V0'ındaki tüm uç noktaların kullanımdan kaldırıldığını lütfen unutmayın, böylece kullanıcılar bir sonraki kullanılabilir sürüme yükseltmelidir

Uç noktalardaki değişiklikler

Her uç noktadaki değişiklikler için lütfen aşağıya bakın. Bu benzer şekilde yapılandırılmıştır API belgeleri (opens new window) kullanım kolaylığı için.

Not: Tüm uç noktaların değişiklikleri olmadı.

Allow Custom

• allow_custom, tüm tag_type nesnelerinin döndürülen uç noktaları için yanıt gövdesinde yeni bir anahtardır. Bu özellik, tag_type'ın özel etiketleri kabul edip etmediğini veya true veya false boole değeri kullanmadığını gösterir.

  
  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
  
        }
  
  

Etiket

GET /tags

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Silinmiş etiketleri almak için yeni sorgular eklendi. Bakınız Bölümün üstünde daha fazla bilgi için.

• item_limit sorgunun yerini page_limit sorgusu, sayfalandırmanın bir parçası olarak değiştirildi.

• tag_scope için yeni bir sorgu var, bu bir veya daha fazla project_id 'olabilir ve verilen tag_scope ile tüm etiketleri döndürür. Kapsamı olmayan tüm etiketler için boş (null) sorgu dizesi filtreleri, yani global etiketler.

• omit_global (BOOL) için yeni bir sorgu mevcuttur. Doğruysa, bu sonuçtan tüm küresel etiketleri (tag_scope = null olanlar) atlar. Bu sorgu için varsayılan değer false.

• tag_type için yanıt gövdesindeki tag nesnesi artık yeni bir allow_custom anahtarı içeriyor. Bakınız bu bölüm daha fazla bilgi için.

POST /tags

• Bu, kullanıcıların yeni bir etiket eklemesini sağlayan yeni bir uç noktadır.

• Herhangi bir kullanıcı, bir projeye kapsamlı özel bir etiket gönderebilir (yani tag_type ve allow_custom: true özelliğine sahip tag_scope: your-project-uuid olan bir etiket). Global etiketlerin yayınlanması yönetici ayrıcalıkları gerektirir.

GET /tags/:tag_id

• Yanıt gövdesindeki tag_type nesnesi artık yeni bir allow_custom anahtarı içeriyor. Bakınız bu bölüm daha fazla bilgi için.

PATCH /tags/:tag_id

• Bu, bir etiket name özelliğini güncellemenizi sağlayan yeni bir uç noktadır.

• Bu uç nokta yönetici ayrıcalıkları gerektirir.

DELETE /tags/:tag_id

• Bu, bir etiketi tag_id ile silmenizi sağlayan yeni bir uç noktadır.

• Bu uç nokta yönetici ayrıcalıkları gerektirir.

Etiket bağlantıları

GET /tags/:tag_id/links

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Silinmiş etiket bağlantılarını almak için yeni sorgular eklendi. Bakınız Bölümün üstünde daha fazla bilgi için.

GET /tags/:tag_id/links/:reference_id

• Bu, kullanıcıların kaynaklar arasında mevcut bir etiket bağlantısı almaları için yeni bir uç noktadır.

PATCH /tags/{tag_id}/links/{reference_id}

• Bu, bir etiket ve referans arasındaki reference_table ve/veya reference_url bağlantılarını güncellemek için yeni bir uç nokta.

PUT /tag_links

• Bu, kullanıcıların mevcut tag_link'ları yeni koymasına ve/veya güncellemesine olanak tanıyan yeni bir uç noktadır.

Etiket Türü

GET /tag_types

• Pagination eklendi. Lütfen bkz Başlangıç Bölümü daha fazla bilgi için.

• Silinmiş etiket türlerini almak için yeni sorgular eklendi. Bakınız Bölümün üstünde daha fazla bilgi için.

• Yanıt gövdesindeki tag_type nesneleri artık yeni bir allow_custom anahtarı içeriyor. Bakınız bu bölüm daha fazla bilgi için.

POST /tag_types

• Bu, yeni bir tag_type eklemenizi sağlayan yeni bir uç noktadır.

• Bu uç nokta yönetici ayrıcalıkları gerektirir.

GET /tag_types/:tag_type_id

• Yanıt gövdesindeki tag_type nesnesi artık yeni bir allow_custom anahtarı içeriyor. Bakınız bu bölüm daha fazla bilgi için.

PATCH /tag_types/{tag_type_id}

• Bu, kullanıcıların tek bir tag_type güncellemesine izin veren yeni bir uç nokta.

*Not: Bu uç nokta yönetici ayrıcalıkları gerektirir. *

DELETE /tag_types/{tag_type_id}

• Gerekli bir sorgu olarak tag_type_id kullanarak tek bir etiket türünü silen yeni uç nokta

• Bu uç nokta yönetici ayrıcalıkları gerektirir.

Çevre Bağlam Hizmeti

Lütfen bu geçiş notlarını Environmental-Context-Service-api V0'dan V1'e geçmeye yardımcı olmak için kullanın. Bu belge, sürümlerdeki tüm değişiklikleri detaylandırmalıdır.

Kullanımdan kaldırılmış uç noktalar

Kullanıcıların bir sonraki kullanılabilir sürüme yükseltilmeleri için bu API'nin V0'daki tüm uç noktalarının kullanımdan kaldırıldığını lütfen unutmayın.