Đọc lượt khám của phòng khám chỉ bằng một API key.

curl -sS "https://iclinic.phongkhamhieploi.vn/api/integration/v1/encounters?from=2026-09-14&to=2026-09-19&status=all" \
  -H "Authorization: Bearer $ICLINIC_API_KEY"

Authorization: Bearer ick_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -sS "https://iclinic.phongkhamhieploi.vn/api/integration/v1/encounters?from=2026-09-14&to=2026-09-19&status=all&page=0&pageSize=200" \
  -H "Authorization: Bearer $ICLINIC_API_KEY"

const BASE = 'https://iclinic.phongkhamhieploi.vn/api/integration/v1';

// Node 18+ (fetch có sẵn). Duyệt hết mọi trang.
export async function listEncounters({ from, to, status = 'all' }) {
  const pageSize = 200;
  const encounters = [];
  for (let page = 0; ; page += 1) {
    const url = new URL(`${BASE}/encounters`);
    url.search = new URLSearchParams({ from, to, status, page, pageSize });
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.ICLINIC_API_KEY}` },
    });
    if (!res.ok) {
      const { error } = await res.json();
      throw new Error(`${res.status} ${error.code}: ${error.message}`);
    }
    const body = await res.json();
    encounters.push(...body.encounters);
    if (body.encounters.length === 0 || encounters.length >= body.total) return encounters;
  }
}

import os
import requests

BASE = "https://iclinic.phongkhamhieploi.vn/api/integration/v1"


def list_encounters(from_date, to_date, status="all"):
    """Duyệt hết mọi trang."""
    headers = {"Authorization": f"Bearer {os.environ['ICLINIC_API_KEY']}"}
    encounters, page = [], 0
    while True:
        res = requests.get(
            f"{BASE}/encounters",
            headers=headers,
            params={"from": from_date, "to": to_date, "status": status,
                    "page": page, "pageSize": 200},
            timeout=30,
        )
        res.raise_for_status()
        body = res.json()
        encounters += body["encounters"]
        if not body["encounters"] or len(encounters) >= body["total"]:
            return encounters
        page += 1

{
  "requestId": "req_7c1f3a",
  "from": "2026-09-14",
  "to": "2026-09-19",
  "page": 0,
  "pageSize": 200,
  "total": 1,
  "encounters": [
    {
      "id": "BA-000123",
      "encounterUuid": "3f0c9a52-6d1b-4e7a-9b1e-2a4c8d5e7f10",
      "patientName": "Nguyễn Văn A",
      "phone": "0900000001",
      "visitDate": "2026-09-19",
      "checkedInAt": "2026-09-19T02:14:05.000Z",
      "completedAt": null,
      "status": "ONGOING",
      "patientType": "OLD",
      "diagnosis": "Tăng huyết áp",
      "icd10Code": "I10"
    }
  ]
}

GET …/encounters?from=2026-09-01&to=2026-09-19&pageSize=200&page=0   → total 340, 200 lượt
GET …/encounters?from=2026-09-01&to=2026-09-19&pageSize=200&page=1   → total 340, 140 lượt  (đủ 340, dừng)

{
  "requestId": "req_7c1f3a",
  "error": {
    "code": "INVALID_RANGE",
    "message": "`to` phải sau `from` và khoảng tối đa 31 ngày."
  }
}

async function callWithRetry(url, options, attempts = 4) {
  for (let i = 0; i < attempts; i += 1) {
    const res = await fetch(url, options);
    if (res.status === 429) {
      const seconds = Number(res.headers.get('Retry-After')) || 30;
      await new Promise((r) => setTimeout(r, seconds * 1000));
      continue;
    }
    if (res.status >= 500) {
      await new Promise((r) => setTimeout(r, 2 ** i * 1000));
      continue;
    }
    return res; // 2xx, 4xx: không thử lại
  }
  throw new Error('Hết số lần thử');
}

const DAY = 86_400_000;
const dayOf = (date) => Date.parse(`${date}T00:00:00Z`);

// appointment: { phone, date: 'YYYY-MM-DD' }; encounters: từ status=all
export function appointmentOutcome(appointment, encounters) {
  const near = encounters.filter(
    (e) =>
      e.phone &&
      e.phone === appointment.phone &&
      Math.abs(dayOf(e.visitDate) - dayOf(appointment.date)) <= 5 * DAY,
  );
  if (near.length === 0) return null; // giữ nguyên
  return near.some((e) => e.status !== 'CANCELLED') ? 'Đã đến' : 'Đã huỷ';
}

const OFFSETS = [0, 3, 6, 30];
const addDays = (date, n) =>
  new Date(Date.parse(`${date}T00:00:00Z`) + n * 86_400_000).toISOString().slice(0, 10);

// encounters: status=FINISHED, from = today - 30 ngày
export function callsDueOn(today, encounters) {
  return encounters.flatMap((e) =>
    OFFSETS.filter((n) => addDays(e.visitDate, n) === today).map((n) => ({
      day: n,
      uuid: e.encounterUuid,
      name: e.patientName,
      phone: e.phone,
      kind: e.patientType === 'NEW' ? 'Khách mới' : 'Tái khám',
      diagnosis: e.diagnosis,
    })),
  );
}

https://iclinic.phongkhamhieploi.vn/developers/openapi.json

# Nhập vào Postman, Insomnia hoặc trình sinh mã:
npx @openapitools/openapi-generator-cli generate \
  -i https://iclinic.phongkhamhieploi.vn/developers/openapi.json \
  -g typescript-fetch -o ./iclinic-client