# Di cư đến V2

Hướng dẫn này giải thích cách di chuyển từ V1 sang V2, cho các dịch vụ microser bị ảnh hưởng.

# Thay đổi trên các dịch vụ

# Truy vấn các mục đã xóa

Nhận các điểm cuối cho phép trả về các mục đã xóa hiện có sẵn các truy vấn sau:

show_active - Cờ Boolean (mặc định true)
show_deleted - Một lá cờ Boolean (mặc định false) để trả về các mục đã xóa trong thân phản hồi.

Theo mặc định, các mục hoạt động sẽ chỉ được trả lại.

Để chỉ trả về các mục đã xóa, yêu cầu với show_deleted giá trị true và show_active Giá trị false.

Để trả về cả các mục hoạt động và bị xóa, yêu cầu với show_deleted giá trị true.

Lưu ý: Một số điểm cuối chỉ chứa truy vấn show_deleted, nhưng hành vi này là như nhau.

# Dịch vụ bình luận

Vui lòng sử dụng các ghi chú di chuyển này để giúp chuyển từ V1 của comments-service-api sang V2. Tài liệu này sẽ chi tiết tất cả các thay đổi trên các phiên bản.

# Điểm cuối không dùng nữa

Xin lưu ý rằng tất cả các điểm cuối trong V1 của API này được không dùng nữa để người dùng phải nâng cấp lên phiên bản có sẵn tiếp theo càng sớm càng tốt

# Thay đổi trên các điểm cuối

Vui lòng xem bên dưới để biết các thay đổi cho mỗi điểm cuối. Điều này được cấu trúc theo cách tương tự như Tài liệu API (opens new window) Để dễ sử dụng.

Lưu ý: Không phải tất cả các điểm cuối đã có thay đổi.

# Bình luận

# `GET /comments`

Truy vấn comment_id hiện chấp nhận nhiều ID trong một mảng, cho phép người dùng lọc cho nhiều nhận xét cùng một lúc.

# `POST /comments`

Điểm cuối này hiện chấp nhận một mảng các đối tượng bình luận trong thân yêu cầu, cho phép người dùng đăng nhiều nhận xét cùng một lúc:


+ [

    {

        reference_id: "79b577e3-f11e-4b7e-b91d-65c501a0926d",

        reference_table: "assets",

        reference_url: "http://testapi.com/api/assets",

        content: "Test comment"

    }

+ ]

# Dịch vụ dữ liệu tham khảo

Vui lòng sử dụng các ghi chú di chuyển này để giúp chuyển từ V1 của reference-data-service-api sang V2. Tài liệu này sẽ chi tiết tất cả các thay đổi trên các phiên bản.

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

Lưu ý: Không phải tất cả các điểm cuối đã có thay đổi.

# Loại nguồn

# `GET /source_types`

Logic truy vấn show_deleted đã được cập nhật. Vui lòng xem phần trên để biết thêm thông tin.

# Nguồn

# `GET /sources`

Logic truy vấn show_deleted đã được cập nhật. Vui lòng xem phần trên để biết thêm thông tin.

# Dịch vụ QA

Vui lòng sử dụng các ghi chú di chuyển này để giúp chuyển từ V1 của qa-data-service-api sang V2. Tài liệu này sẽ chi tiết tất cả các thay đổi trên các phiên bản.

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

# Hồ sơ

# `POST /records`

Điểm cuối này đã được cập nhật để chấp nhận một loạt các hồ sơ trong thân yêu cầu. Điều này cho phép người dùng đăng nhiều bản ghi mới cùng một lúc:


+ [

    {

        "type_id": "f3f25a90-5caa-459a-ab8b-ab0a4dc20e42",

        "reference_id": "79b577e3-f11e-4b7e-b91d-65c501a0926d",

        "reference_table": "assets",

        "reference_url": "http://testapi.com/api/assets"

    }

+ ]

# Dịch vụ bối cảnh môi trường

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

Những thay đổi chính đến từ công tắc API, chúng tôi hiện đang sử dụng quảng cáo (dịch vụ dữ liệu Arup) thay vì CD (Dịch vụ dữ liệu doanh nghiệp)

Lưu ý: Không phải tất cả các điểm cuối đã có thay đổi.

# Dự án

# `GET /projects & /ads/projects`

Các khóa phản hồi đã thay đổi


{

"projects": [

 {

 "centre_code": "509",

 "confidential": false,

- "job_name_short": "V & A MUSEUM, DUNDEE",

+ "short_title": "V & A MUSEUM, DUNDEE",

- "job_number": "216899",

- "job_suffix": "00",

- "project_code": "21689900",

+ "project_number": "21689900",

- "organisation_name": "KENGO KUMA & ASSOCIATES",

+ "client_organisation_name": "KENGO KUMA & ASSOCIATES",

 "number": "21689900",

 "project_director_email": "[email protected]",

 "project_director_name": "User Name",

 "project_id": "ca1e89a5-780d-4dc9-96e9-41f3c7aaa810",

 "project_manager_email": "[email protected]",

 "project_manager_name": "User Name",

 "project_url": "http://projects.intranet.arup.com/?layout=projects.proj.view&jp=OA&jn=26190800",

 "scope_of_works": "A new waterfront museum for Dundee City Council"

 }

]

}

# `GET, PATCH /projects/{id} & POST /projects`

Các khóa phản hồi đã thay đổi


{

"project": {

 "centre_code": "509",

 "confidential": false,

- "job_name_short": "V & A MUSEUM, DUNDEE",

+ "short_title": "V & A MUSEUM, DUNDEE",

- "job_number": "216899",

- "job_suffix": "00",

- "project_code": "21689900",

+ "project_number": "21689900",

- "organisation_name": "KENGO KUMA & ASSOCIATES",

+ "client_organisation_name": "KENGO KUMA & ASSOCIATES",

 "project_director_email": "[email protected]",

 "project_director_name": "User Name",

 "project_id": "ca1e89a5-780d-4dc9-96e9-41f3c7aaa810",

 "project_manager_email": "[email protected]",

 "project_manager_name": "User Name",

 "project_url": "http://projects.intranet.arup.com/?layout=projects.proj.view&jp=OA&jn=26190800",

 "scope_of_works": "A new waterfront museum for Dundee City Council."

 "created_at": "2019-05-10T13:45:08.000Z",

 "updated_at": "2019-05-10T13:45:08.000Z",

 "deleted_at": "2019-05-10T13:45:08.000Z"

 }

}

# Quốc gia

# `GET /countries`

Các khóa phản hồi đã thay đổi


{

 "countries": [

 {

 "country_class": "A",

 "country_code": "C163",

 "country_id": "64fde841-4950-e711-8104-005056b57459",

 "country_name": "Northern Ireland",

 "iso_code": "GB",

 "iso_country_name": "United Kingdom",

- "iso_formal_country_name": "United Kingdom of Great Britain and Northern Ireland",

+ "iso_formal_name": "United Kingdom of Great Britain and Northern Ireland",

 "region": {

 "region_code": "B04",

 "region_id": "9c54bb0d-4950-e711-8104-005056b57459",

 "region_name": "UKIMEA Region",

- "arup_region_level": 1,

- "company_code": C01,

 }

 }

 ]

}

# Vùng

# `GET /regions`

Các khóa phản hồi đã thay đổi


{

 "regions": [

 {

 "region_code": "B04",

 "region_id": "9c54bb0d-4950-e711-8104-005056b57459",

 "region_name": "UKIMEA Region",

- "arup_region_level": 1,

- "company_code": C01,

 }

 ]

}

← Migration to v1

# Di cư đến V2

# Thay đổi trên các dịch vụ

# Truy vấn các mục đã xóa

# Dịch vụ bình luận

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

# Bình luận

# GET /comments

# POST /comments

# Dịch vụ dữ liệu tham khảo

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

# Loại nguồn

# GET /source_types

# Nguồn

# GET /sources

# Dịch vụ QA

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

# Hồ sơ

# POST /records

# Dịch vụ bối cảnh môi trường

# Điểm cuối không dùng nữa

# Thay đổi trên các điểm cuối

# Dự án

# GET /projects & /ads/projects

# GET, PATCH /projects/{id} & POST /projects

# Quốc gia

# GET /countries

# Vùng

# GET /regions

# `GET /comments`

# `POST /comments`

# `GET /source_types`

# `GET /sources`

# `POST /records`

# `GET /projects & /ads/projects`

# `GET, PATCH /projects/{id} & POST /projects`

# `GET /countries`

# `GET /regions`