NHÀ PHÁT TRIỂN

Bắt đầu nhanh

Hoàn thành trọn vẹn một luồng Observation giả lập, bao gồm định danh, phạm vi quyền, ngữ nghĩa FHIR, tính lũy đẳng và mã tương quan.

01 / KHÁI NIỆM

Hợp đồng tích hợp

Điều kiện

Ứng dụng sandbox, ứng dụng khách OAuth, phạm vi Observation và đối tượng giả lập.

Xác thực

Dùng loại ứng dụng khách và luồng OAuth 2.1/OIDC được cấp; ứng dụng khách có người dùng dùng Authorization Code + PKCE.

Yêu cầu

Gửi FHIR R4 Observation với định danh giả lập và khóa lũy đẳng (idempotency key).

Xác minh

Kiểm tra trạng thái, mã tương quan, nhật ký tích hợp (Integration Logs) và gửi lặp yêu cầu để xác thực tính lũy đẳng.

02 / QUY TRÌNH

Từ môi trường thử nghiệm tới bằng chứng

01Lấy token sandbox
02Tạo Observation giả lập
03POST với FHIR media type/khóa lũy đẳng
04Xác thực phản hồi/OperationOutcome
05Tra mã tương quan trong nhật ký tích hợp
06Lặp lại với một trường hợp lỗi

03 / MÃ NGUỒN

Gửi Observation — chỉ dùng dữ liệu giả

curl

curl -X POST https://sandbox.example.invalid/fhir/Observation \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/fhir+json" \
  -H "Idempotency-Key: demo-obs-001" \
  --data '{"resourceType":"Observation","status":"final","subject":{"reference":"Patient/synthetic-001"},"code":{"text":"Synthetic systolic blood pressure"},"valueQuantity":{"value":120,"unit":"mmHg"}}'

Java

var req = HttpRequest.newBuilder(URI.create(base + "/fhir/Observation"))
  .header("Authorization", "Bearer " + token)
  .header("Content-Type", "application/fhir+json")
  .header("Idempotency-Key", "demo-obs-001")
  .POST(HttpRequest.BodyPublishers.ofString(syntheticObservationJson))
  .build();
var res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());

JavaScript

const res = await fetch(`${base}/fhir/Observation`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/fhir+json", "Idempotency-Key": "demo-obs-001" },
  body: JSON.stringify(syntheticObservation)
});
if (!res.ok) throw await res.json();

Kotlin

val request = Request.Builder()
  .url("$base/fhir/Observation")
  .header("Authorization", "Bearer $token")
  .header("Content-Type", "application/fhir+json")
  .header("Idempotency-Key", "demo-obs-001")
  .post(syntheticObservationJson.toRequestBody("application/fhir+json".toMediaType()))
  .build()

Swift

var request = URLRequest(url: URL(string: base + "/fhir/Observation")!)
request.httpMethod = "POST"
request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")
request.setValue("application/fhir+json", forHTTPHeaderField: "Content-Type")
request.setValue("demo-obs-001", forHTTPHeaderField: "Idempotency-Key")
request.httpBody = syntheticObservationData

04 / BẢO MẬT & VẬN HÀNH

Vận hành chính thức là quyết định dựa trên bằng chứng

Bắt đầu nhanh chỉ chứng minh một luồng Observation giả lập. Vận hành chính thức cần có người phụ trách tích hợp, phạm vi quyền, bảo vệ thông tin xác thực, kiểm thử lỗi/thử lại, giám sát và bằng chứng khôi phục.