臺灣愛滋病實作指引
0.1.0 - ci-build Taiwan, Province of China flag

臺灣愛滋病實作指引, published by 衛福部疾病管制署. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/omnifhir/aids/ and changes regularly. See the Directory of published versions

CapabilityStatement: 臺灣結核病-伺服端(AIDS Server)

Official URL: https://cdc.gov.tw/aids/CapabilityStatement/CapabilityStatementAIDSServer Version: 0.1.0
Active as of 2026-03-31 Computable Name: CapabilityStatementAIDSServer

臺灣愛滋病實作指引(TWAIDS IG)伺服端(Server)之能力聲明

Raw OpenAPI-Swagger Definition file | Download

臺灣結核病-伺服端(AIDS Server)

  • Implementation Guide Version: 0.1.0
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Supported Patch Formats: application/json-patch+json
  • Published on: 2026-03-31
  • Published by: 衛福部疾病管制署

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

SHALL Support the Following Implementation Guides

FHIR RESTful Capabilities

Mode: server

臺灣結核病-伺服端(AIDS Server)必須(SHALL)：(1)支援本實作指引中所有profiles (2)根據FHIR規範實作RESTful (3)回傳狀態碼-①(Status 400)：無效參數(invalid parameter)、②(Status 401/4xx)：未經授權的請求(unauthorized request)、③(Status 403)：未充分授權的資料存取範圍(insufficient premission scope)、④(Status 404)：未知的resource(unknown resource) (4)支援JSON格式 (5)可識別每個新增到Server的實例(instance)之meta.profile是否為臺灣事前審查Profiles Defining URL，並確認實例是否依循Profile製作。臺灣事前審查-伺服端建議應該(SHOULD)：(1)支援XML格式。

Security
Enable CORS: no
Security services supported: SMART-on-FHIR

Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求。

Summary of System-wide Interactions
  • SHOULD support the transactioninteraction.
  • SHOULD support the batchinteraction.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRV-RSUCSearches_include_revincludeOperations
BundleSupported Profiles
  https://cdc.gov.tw/aids/StructureDefinition/Bundle-aids-reporting
  用藥通報-Bundle AIDS Drug
  https://cdc.gov.tw/aids/StructureDefinition/Bundle-aids-check		YYYY
MessageHeaderSupported Profiles
  https://cdc.gov.tw/aids/StructureDefinition/MessageHeader-aids-reporting
  用藥通報訊息-MessageHeader AIDS Drug
  https://cdc.gov.tw/aids/StructureDefinition/MessageHeader-aids-check		YYYY
DiagnosticReportSupported Profiles
  https://cdc.gov.tw/aids/StructureDefinition/DiagnosticReport-aids-reporting
  https://cdc.gov.tw/aids/StructureDefinition/DiagnosticReport-aids-check		YYYY
Organizationhttps://cdc.gov.tw/aids/StructureDefinition/Organization-aidsYYYY
Patienthttps://cdc.gov.tw/aids/StructureDefinition/Patient-aidsYYYY
ObservationSupported Profiles
  https://cdc.gov.tw/aids/StructureDefinition/Observation-smear
  https://cdc.gov.tw/aids/StructureDefinition/Observation-mgit
  https://cdc.gov.tw/aids/StructureDefinition/Observation-lj
  https://cdc.gov.tw/aids/StructureDefinition/Observation-identify
  https://cdc.gov.tw/aids/StructureDefinition/Observation-drug-sensitive-1
  https://cdc.gov.tw/aids/StructureDefinition/Observation-drug-sensitive-2
  https://cdc.gov.tw/aids/StructureDefinition/Observation-sputum-pcr
  https://cdc.gov.tw/aids/StructureDefinition/Observation-igra
  https://cdc.gov.tw/aids/StructureDefinition/Observation-xpert-maidsc
  https://cdc.gov.tw/aids/StructureDefinition/Observation-xpert-rmp
  https://cdc.gov.tw/aids/StructureDefinition/Observation-genotype
  https://cdc.gov.tw/aids/StructureDefinition/Observation-moleculex
  https://cdc.gov.tw/aids/StructureDefinition/Observation-aids-check
  TW Core Observation Body Weight		YYYY
SpecimenSupported Profiles
  https://cdc.gov.tw/aids/StructureDefinition/Specimen-aids-reporting
  用藥通報檢體-Specimen AIDS Drug		YYYY
EncounterSupported Profiles
  就醫資訊-Encounter AIDS Drug
  https://cdc.gov.tw/aids/StructureDefinition/Encounter-aids-check		YYYY
Practitionerhttps://cdc.gov.tw/aids/StructureDefinition/Practitioner-aidsYYYY
Core FHIR Resource
Bundle
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

https://cdc.gov.tw/aids/StructureDefinition/Bundle-aids-reporting
用藥通報-Bundle AIDS Drug
https://cdc.gov.tw/aids/StructureDefinition/Bundle-aids-check

Core FHIR Resource
MessageHeader
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

https://cdc.gov.tw/aids/StructureDefinition/MessageHeader-aids-reporting
用藥通報訊息-MessageHeader AIDS Drug
https://cdc.gov.tw/aids/StructureDefinition/MessageHeader-aids-check

Core FHIR Resource
DiagnosticReport
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

https://cdc.gov.tw/aids/StructureDefinition/DiagnosticReport-aids-reporting
https://cdc.gov.tw/aids/StructureDefinition/DiagnosticReport-aids-check

Base System Profile
醫事機構-Organization AIDS
Profile Conformance
SHALL
Reference Policy
resolves

Interaction summary
  • SHALL support create, read, vread, update.

Base System Profile
病人資訊-Patient AIDS
Profile Conformance
SHALL
Reference Policy
resolves

Interaction summary
  • SHALL support create, read, vread, update.

Core FHIR Resource
Observation
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

https://cdc.gov.tw/aids/StructureDefinition/Observation-smear
https://cdc.gov.tw/aids/StructureDefinition/Observation-mgit
https://cdc.gov.tw/aids/StructureDefinition/Observation-lj
https://cdc.gov.tw/aids/StructureDefinition/Observation-identify
https://cdc.gov.tw/aids/StructureDefinition/Observation-drug-sensitive-1
https://cdc.gov.tw/aids/StructureDefinition/Observation-drug-sensitive-2
https://cdc.gov.tw/aids/StructureDefinition/Observation-sputum-pcr
https://cdc.gov.tw/aids/StructureDefinition/Observation-igra
https://cdc.gov.tw/aids/StructureDefinition/Observation-xpert-maidsc
https://cdc.gov.tw/aids/StructureDefinition/Observation-xpert-rmp
https://cdc.gov.tw/aids/StructureDefinition/Observation-genotype
https://cdc.gov.tw/aids/StructureDefinition/Observation-moleculex
https://cdc.gov.tw/aids/StructureDefinition/Observation-aids-check
TW Core Observation Body Weight

Core FHIR Resource
Specimen
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

https://cdc.gov.tw/aids/StructureDefinition/Specimen-aids-reporting
用藥通報檢體-Specimen AIDS Drug

Core FHIR Resource
Encounter
Reference Policy
resolves
Interaction summary
  • SHALL support create, read, vread, update.

Supported Profiles

就醫資訊-Encounter AIDS Drug
https://cdc.gov.tw/aids/StructureDefinition/Encounter-aids-check

Base System Profile
醫師-Practitioner AIDS
Profile Conformance
SHALL
Reference Policy
resolves

Interaction summary
  • SHALL support create, read, vread, update.