# Migrasi ke V1

Panduan ini menerangkan cara berhijrah dari V0 hingga V1, untuk microservices yang terjejas.

# Perubahan di seluruh perkhidmatan

# Meminta item yang dipadam

Dapatkan titik akhir yang membolehkan pulangan item yang dipadam kini mempunyai pertanyaan berikut yang tersedia:

show_active - Bendera Boolean (lalai true) untuk mengembalikan item yang tidak dipadamkan (iaitu aktif) dalam badan tindak balas
show_deleted - Bendera Boolean (lalai false) untuk mengembalikan item yang dipadam dalam badan tindak balas.

Secara lalai, item aktif akan dikembalikan sahaja.

Untuk mengembalikan item yang dipadam sahaja, permintaan dengan nilai show_deleted true dan show_active nilai false.

Untuk mengembalikan item aktif dan dipadam, minta nilai show_deleted true.

Nota: Sesetengah titik akhir mengandungi pertanyaan show_deleted sahaja, tetapi tingkah laku adalah sama.

# Penomboran

Pagination telah ditambah ke beberapa laluan di seluruh perkhidmatan. Ini adalah tindak balas yang sangat besar dapat diuruskan dengan munasabah.

Pagination menambah pertanyaan baru kepada mana -mana titik akhir yang dipertikaikan:

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

Di mana tidak hadir sebelum ini, pertanyaan baru order dan sort_by juga akan hadir pada titik akhir paginated:

+ ?sort_by=name
+ ?order=desc

Sila lihat dokumentasi untuk maklumat lanjut mengenai pertanyaan ini.

Badan tindak balas untuk titik akhir paginate juga telah dikemas kini dengan kunci baru:

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

# Mesej ralat

Respons Ralat Pelanggan tidak lagi termasuk kunci source:

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

# Perkhidmatan Parameter

Sila gunakan nota penghijrahan ini untuk membantu beralih dari V0 dari parameter-service-api ke V1. Bahagian ini harus memperincikan semua perubahan di seluruh versi.

# Titik akhir yang tidak ditetapkan

Titik akhir berikut telah dikeluarkan dari v1:

# `GET /parameters/:parameter_id/revision`

digantikan oleh titik akhir baru GET /entries/:entry_id/revisions (lihat di bawah)

# `POST /parameters/:parameter_id/revision`

digantikan oleh titik akhir baru PUT /entries (lihat di bawah)

# `PATCH /parameters/:parameter_id/revision`

digantikan oleh titik akhir baru PATCH /revisions (lihat di bawah)

# Perubahan di titik akhir

Sila lihat di bawah untuk perubahan pada setiap titik akhir. Ini berstruktur dengan cara yang sama dengan Dokumentasi API (opens new window) untuk kemudahan penggunaan.

Nota: Tidak semua titik akhir mempunyai perubahan.

# Aset

# `GET /assets`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

Badan tindak balas sekarang termasuk asset_type_id harta dalam kunci 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"
    }

Pertanyaan show_deleted_assets telah diganti. Sila lihat bahagian di atas untuk maklumat lanjut
```
- GET /assets?show_deleted_assets=true
+ GET /assets?show_deleted=true
```

# `POST /assets`

Titik akhir ini kini menerima salah satu asset_type_id atau asset_sub_type_id dalam badan permintaan:
Jika anda menyediakan asset_sub_type_id maka medan name adalah pilihan dan jika dibiarkan kosong akan dihuni secara automatik untuk memadankan nama asset_sub_type.
Jika anda menyediakan asset_type_id hanya untuk aset yang mempunyai asset_sub_type harta true, anda akan menerima ralat jika menyiarkan dengan harta name tidak sepadan dengan salah satu nama sub jenis yang sah.

Badan tindak balas kini termasuk asset_type_id harta di kunci 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}`

Badan tindak balas sekarang termasuk asset_type_id harta dalam kunci 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"
    }

Pertanyaan show_deleted_assets telah diganti. Sila lihat bahagian di atas untuk maklumat lanjut
```
- GET /assets?show_deleted_assets=true
+ GET /assets?show_deleted=true
```

# `GET /assets/{asset_ids}/hierarchy`

Setiap objek hierarchy dalam badan tindak balas kini termasuk kunci asset_type_id:

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

# Penyertaan

Entri mewakili nilai untuk parameter. Penyertaan boleh disemak semula. Pada masa ini, parameter terhad kepada maksimum satu entri. Dalam versi masa depan, parameter akan mempunyai keupayaan untuk mempunyai pelbagai entri. Sila lihat Dokumentasi (opens new window) untuk maklumat lanjut.

Terdapat empat laluan baru yang berkaitan dengan penyertaan:

# `GET /entries`

Titik akhir ini mengembalikan semua penyertaan, ini boleh dipersoalkan oleh pelbagai parameter_id.

# `PUT /entries`

Titik akhir ini menggantikan POST /parameters/:parameter_id/revision dan membolehkan anda membuat atau mengemas kini satu atau lebih entri.
Titik akhir ini menerima pelbagai entries. Bidang yang diperlukan adalah entry_id, parameter_id, source_id, values. Pada masa ini, values mempunyai panjang maksimum satu. Penambahan pilihan adalah comment dan location_in_source.

# `GET /entries/:entry_id/revisions`

Titik akhir ini menggantikan GET /parameters/:parameter_id/revision, dan mengembalikan semua semakan untuk entry_id yang ditentukan.

# `PATCH /revisions`

Titik akhir ini menggantikan titik akhir PATCH /parameters/:parameter_id/revisions dan membolehkan pengguna mengemas kini status pelbagai semakan yang berkaitan dengan pelbagai entri yang berbeza sekaligus.
Pengguna hanya perlu mengemas kiniterkinisemakan entri
Pengguna dikehendaki menentukan revision_id semakan untuk mengemas kini
Jika pengguna mengemas kini semakan status ke QA State rejected A comment harta diperlukan.

# Set parameter

Nota: Set parameter berada dalam pelepasan alfa untuk ujian. Ia tidak disyorkan untuk menggunakan laluan ini dalam pengeluaran.

Konvensyen penamaan untuk set parameter telah diubah dari V0 hingga V1. Perubahan adalah seperti berikut:

Konvensyen Penamaan V0	Konvensyen Penamaan V1
`parameter_set_type`	`parameter_set_category`
`parameter_set`	`parameter_set_type`
`parameter_set_instance`	`parameter_set`

Ini telah menghasilkan kemas kini laluan dengan cara berikut:

V0 Route	Laluan 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`

Kekunci pada badan tindak balas telah dikemas kini dengan cara yang relevan. Contohnya permintaan kepada GET /parameter_set_categories (sebelum ini dikenali sebagai GET /parameter_set_types) akan mengembalikan respons dengan:

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

Semua titik akhir harus berkelakuan dengan cara yang sama (tidak termasuk titik akhir terperinci di bawah).

# `GET /parameter_sets`

Titik akhir ini menggantikan titik akhir V0 GET /parameter_sets/:parameter_set_id/instances. Untuk menapis parameter set oleh parameter_set_type_id yang berkaitan Ini diluluskan melalui pertanyaan pada titik akhir:

+ GET /parameter_sets?parameter_set_type_id=uuid

Ini akan mengembalikan semua parameter_sets dari parameter_set_type_id yang ditentukan.

# `GET /parameter_sets/:parameter_set_id/parameters`

Titik akhir ini mengandungi tindak balas yang dikurangkan berbanding dengan versi 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
}

# Parameter

# `GET /parameters`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.
Pertanyaan show_deleted_parameters telah diganti. Sila lihat bahagian di atas untuk maklumat lanjut
```
- GET /parameters?show_deleted_parameters=true
+ GET /assets?show_deleted=true
```
Pertanyaan offset telah dikeluarkan:
```
- GET /parameters?offset=
```

Kunci revision dalam badan tindak balas telah dinamakan semula menjadi selected_entry:

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

Kunci selected_entry.source mengandungi tindak balas yang dikurangkan

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

Kunci selected_entry.created_by mengandungi tindak balas yang dikurangkan

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

Kunci selected_entry tidak mempunyai harta updated_at, comment atau location_in_source.

# `POST /parameters`

Kunci revision dalam badan permintaan telah digantikan dengan entries, yang menerima array.
Terdapat kunci entry_id pilihan dalam badan pos entries:
Sekiranya anda menambah entri baru ketidak dijawabParameter, ini boleh dibiarkan kosong dan secara automatik akan mengisi dengan UUID baru.
Sekiranya anda ingin menyemak semuladijawabParameter, anda mesti menyediakan entry_id sedia ada untuk menyemak semula.

Ini kini terhad kepada satu item dalam harta entries sahaja.

Kunci revision dalam badan respons pos kini dinamakan semula menjadi selected_entry
```
- revision: { ... }
+ selected_entry: { ... }
```

# `GET /parameters/{parameter_id}`

Pertanyaan show_deleted_parameters telah diganti. Sila lihat bahagian di atas untuk maklumat lanjut

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

Kunci revision dalam badan tindak balas telah dinamakan semula menjadi selected_entry
```
- revision: { ... }
+ selected_entry: { ... }
```

Kunci selected_entry.source mengandungi tindak balas yang dikurangkan

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

Kunci selected_entry.created_by mengandungi tindak balas yang dikurangkan

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

Kunci selected_entry tidak mempunyai harta updated_at, comment atau location_in_source.

# Pokok

Terdapat beberapa titik akhir baru untuk mengembalikan hierarki pokok. Sila lihat Dokumentasi (opens new window) Untuk maklumat lanjut mengenai titik akhir ini.

# `GET /asset_tree`

Titik akhir baru yang mengembalikan pokok aset dengan asset_id.

# `GET /asset_type_tree`

Titik akhir baru yang mengembalikan pokok jenis aset dengan asset_type_id.

# Jenis

# `GET /asset_type_groups`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

# `GET /asset_types`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

# `GET /asset_types/{asset_type_id}/asset_sub_types`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

# `GET /parameter_types`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

Kunci name pada harta default_unit di badan tindak balas telah dinamakan semula menjadi symbol:

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`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.
Pertanyaan offset telah dikeluarkan.

# `GET /unit_types`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

Setiap objek unit_type mempunyai kunci unit_systems baru, yang mengandungi sistem unit dan unit yang tersedia untuk jenis tertentu

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`

Badan respons unit_types untuk kaedah pos telah dikemas kini dengan cara yang sama seperti GET /unit_types - sila rujuk bahagian ini untuk maklumat lanjut.

# `GET /unit_types/:unit_type_id`

Badan tindak balas objek unit_type kini termasuk created_at, updated_at dan deleted_at kekunci:

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

# Unit

# `GET /units`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

Kunci name dalam badan tindak balas telah dinamakan semula menjadi symbol:

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

Badan permintaan tidak lagi menerima bidang name. Ini sekarang harus symbol:

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

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.

# Perkhidmatan metadata parameter

Sila gunakan nota penghijrahan ini untuk membantu beralih dari V0 dari parameter-metadata-service-api ke V1. Dokumen ini harus memperincikan semua perubahan di seluruh versi.

# Titik akhir yang tidak ditetapkan

Sila ambil perhatian bahawa semua titik akhir di V0 API ditahan sehingga pengguna mesti menaik taraf ke versi yang tersedia seterusnya

# Perubahan di titik akhir

Sila lihat di bawah untuk perubahan pada setiap titik akhir. Ini berstruktur dengan cara yang sama dengan Dokumentasi API (opens new window) untuk kemudahan penggunaan.

Nota: Tidak semua titik akhir mempunyai perubahan.

# `Allow Custom`

allow_custom adalah kunci baru dalam badan tindak balas untuk semua objek tag_type kembali titik akhir. Harta ini menandakan jika tag_type menerima tag tersuai atau tidak menggunakan nilai boolean true atau false.

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
      }

# Tag

# `GET /tags`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.
Pertanyaan baru ditambah untuk mendapatkan tag yang dipadam. Sila lihat bahagian di atas untuk maklumat lanjut.
Pertanyaan item_limit telah digantikan dengan pertanyaan page_limit sebagai sebahagian daripada penomboran.
Terdapat pertanyaan baru yang tersedia untuk tag_scope, ini boleh menjadi satu atau lebih project_id dan akan mengembalikan semua tag dengan tag_scope yang diberikan. Penapis rentetan pertanyaan kosong (null) untuk semua tag tanpa skop, iaitu tag global.
Terdapat pertanyaan baru yang tersedia untuk omit_global (bool). Jika benar, ini menghilangkan semua tag global (mereka yang mempunyai tag_scope = null) dari hasilnya. Nilai lalai untuk pertanyaan ini ialah false.
Objek tag_type dalam badan tindak balas untuk tag kini termasuk kunci baru allow_custom. Sila lihat bahagian ini untuk maklumat lanjut.

# `POST /tags`

Ini adalah titik akhir baru yang membolehkan pengguna menambah tag baru.
Mana -mana pengguna boleh menyiarkan tag tersuai yang dilancarkan ke projek (iaitu tag yang mempunyai tag_type dengan harta allow_custom: true dan tag_scope: your-project-uuid). Menyiarkan tag global memerlukan keistimewaan admin.

# `GET /tags/:tag_id`

Objek tag_type dalam badan tindak balas kini termasuk kunci baru allow_custom. Sila lihat bahagian ini untuk maklumat lanjut.

# `PATCH /tags/:tag_id`

Ini adalah titik akhir baru yang membolehkan anda mengemas kini harta name.
Titik akhir ini memerlukan keistimewaan admin.

# `DELETE /tags/:tag_id`

Ini adalah titik akhir baru yang membolehkan anda memadam tag dengan tag_id.
Titik akhir ini memerlukan keistimewaan admin.

# Pautan tag

# `GET /tags/:tag_id/links`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.
Pertanyaan baru ditambah untuk mendapatkan pautan tag yang dipadam. Sila lihat bahagian di atas untuk maklumat lanjut.

# `GET /tags/:tag_id/links/:reference_id`

Ini adalah titik akhir baru bagi pengguna untuk mendapatkan pautan tag sedia ada antara sumber.

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

Ini adalah titik akhir baru untuk mengemas kini pautan reference_table dan/atau reference_url antara tag dan rujukan.

# `PUT /tag_links`

Ini adalah titik akhir baru yang membolehkan pengguna meletakkan baru dan/atau mengemas kini tag_link baru.

# Jenis tag

# `GET /tag_types`

Penomboran ditambah. Sila lihat bahagian permulaan untuk maklumat lanjut.
Pertanyaan baru ditambah untuk mendapatkan jenis tag yang dipadam. Sila lihat bahagian di atas untuk maklumat lanjut.
Objek tag_type dalam badan tindak balas kini termasuk kunci baru allow_custom. Sila lihat bahagian ini untuk maklumat lanjut.

# `POST /tag_types`

Ini adalah titik akhir baru yang membolehkan anda menambah tag_type baru.
Titik akhir ini memerlukan keistimewaan admin.

# `GET /tag_types/:tag_type_id`

Objek tag_type dalam badan tindak balas sekarang termasuk kunci baru allow_custom. Sila lihat bahagian ini untuk maklumat lanjut.

# `PATCH /tag_types/{tag_type_id}`

Ini adalah titik akhir baru yang membolehkan pengguna mengemas kini tag_type tunggal.

*Nota: Titik akhir ini memerlukan keistimewaan admin. *

# `DELETE /tag_types/{tag_type_id}`

Titik akhir baru yang memadam satu jenis tag menggunakan tag_type_id sebagai pertanyaan yang diperlukan
Titik akhir ini memerlukan keistimewaan admin.

# Perkhidmatan Konteks Alam Sekitar

Sila gunakan nota penghijrahan ini untuk membantu beralih dari V0 dari Environmental-Context-Service-api ke V1. Dokumen ini harus memperincikan semua perubahan di seluruh versi.

# Titik akhir yang tidak ditetapkan

Sila ambil perhatian bahawa semua titik akhir dalam V0 API ini ditutup sehingga pengguna mesti menaik taraf ke versi yang tersedia seterusnya

← Versi Migrasi ke V2 →

# Migrasi ke V1

# Perubahan di seluruh perkhidmatan

# Meminta item yang dipadam

# Penomboran

# Mesej ralat

# Perkhidmatan Parameter

# Titik akhir yang tidak ditetapkan

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

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

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

# Perubahan di titik akhir

# Aset

# GET /assets

# POST /assets

# GET /assets/{asset_id}

# GET /assets/{asset_ids}/hierarchy

# Penyertaan

# GET /entries

# PUT /entries

# GET /entries/:entry_id/revisions

# PATCH /revisions

# Set parameter

# GET /parameter_sets

# GET /parameter_sets/:parameter_set_id/parameters

# Parameter

# GET /parameters

# POST /parameters

# GET /parameters/{parameter_id}

# Pokok

# GET /asset_tree

# GET /asset_type_tree

# Jenis

# GET /asset_type_groups

# GET /asset_types

# GET /asset_types/{asset_type_id}/asset_sub_types

# GET /parameter_types

# GET /item_types

# GET /unit_types

# POST /unit_types

# GET /unit_types/:unit_type_id

# Unit

# GET /units

# POST /units

# GET /unit_systems

# Perkhidmatan metadata parameter

# Titik akhir yang tidak ditetapkan

# Perubahan di titik akhir

# Allow Custom

# Tag

# GET /tags

# POST /tags

# GET /tags/:tag_id

# PATCH /tags/:tag_id

# DELETE /tags/:tag_id

# Pautan tag

# GET /tags/:tag_id/links

# GET /tags/:tag_id/links/:reference_id

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

# PUT /tag_links

# Jenis tag

# GET /tag_types

# POST /tag_types

# GET /tag_types/:tag_type_id

# PATCH /tag_types/{tag_type_id}

# DELETE /tag_types/{tag_type_id}

# Perkhidmatan Konteks Alam Sekitar

# Titik akhir yang tidak ditetapkan

# `GET /parameters/:parameter_id/revision`

# `POST /parameters/:parameter_id/revision`

# `PATCH /parameters/:parameter_id/revision`

# `GET /assets`

# `POST /assets`

# `GET /assets/{asset_id}`

# `GET /assets/{asset_ids}/hierarchy`

# `GET /entries`

# `PUT /entries`

# `GET /entries/:entry_id/revisions`

# `PATCH /revisions`

# `GET /parameter_sets`

# `GET /parameter_sets/:parameter_set_id/parameters`

# `GET /parameters`

# `POST /parameters`

# `GET /parameters/{parameter_id}`

# `GET /asset_tree`

# `GET /asset_type_tree`

# `GET /asset_type_groups`

# `GET /asset_types`

# `GET /asset_types/{asset_type_id}/asset_sub_types`

# `GET /parameter_types`

# `GET /item_types`

# `GET /unit_types`

# `POST /unit_types`

# `GET /unit_types/:unit_type_id`

# `GET /units`

# `POST /units`

# `GET /unit_systems`

# `Allow Custom`

# `GET /tags`

# `POST /tags`

# `GET /tags/:tag_id`

# `PATCH /tags/:tag_id`

# `DELETE /tags/:tag_id`

# `GET /tags/:tag_id/links`

# `GET /tags/:tag_id/links/:reference_id`

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

# `PUT /tag_links`

# `GET /tag_types`

# `POST /tag_types`

# `GET /tag_types/:tag_type_id`

# `PATCH /tag_types/{tag_type_id}`

# `DELETE /tag_types/{tag_type_id}`