Warning Pipe API

Xác thực

Gửi header Authorization: Bearer <key>. Key được cấp qua email sau khi phê duyệt. Biến môi trường máy chủ: AISENTRA_PIPE_API_KEYS (danh sách cách nhau bởi dấu phẩy).

curl -sH "Authorization: Bearer $AISENTRA_PIPE_KEY" \
  https://aisentra.org/api/v1/pipe

Endpoint

• GET /api/v1/pipe — alerts[] + regions[] (cảnh báo sớm + gợi ý SKU).
• POST /api/v1/pipe/brief — bản tin chuẩn bị tồn kho (JSON { locale: "vi" | "en" }).

curl -sH "Authorization: Bearer $AISENTRA_PIPE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"locale":"vi"}' \
  https://aisentra.org/api/v1/pipe/brief

Trường chính

• alerts[].disease · stage · hoursToAct · stockHints[]
• regions[] — province evidence overlay for warehouse catchment maps
• disclaimer — always present; surface to operators

Không phải tư vấn y khoa. Điểm bằng chứng là thang nội bộ. Xác minh trước khi đặt hàng lớn.

{
  "product": "aisentra-warning-pipe",
  "version": "1",
  "generatedAt": "2026-07-30T06:00:00.000Z",
  "dataMode": "demo",
  "disclaimer": "AISentra Warning Pipe is an early-warning inventory-prep feed derived from public-source epidemic signals. It is not medical advice, not a prescribing guide, and not an official Ministry of Health alert. Evidence scores are an internal ranking scale. Verify with competent authorities before operational decisions.",
  "alerts": [
    {
      "watchId": "w-dengue-hcm",
      "disease": "Dengue",
      "stage": "cluster",
      "evidenceScore": 62,
      "hoursToAct": 36,
      "windowTotalHours": 72,
      "severity": "elevated",
      "cluster": true,
      "scope": "vn",
      "provinces": [
        {
          "code": "HCM",
          "name": "Ho Chi Minh City",
          "nameVi": "TP.HCM"
        }
      ],
      "stockHints": [
        {
          "id": "antipyretic",
          "label": "Antipyretics / analgesics",
          "labelVi": "Hạ sốt / giảm đau"
        },
        {
          "id": "ors",
          "label": "ORS / oral rehydration",
          "labelVi": "Oresol / bù nước điện giải"
        },
        {
          "id": "dengue-test",
          "label": "Dengue rapid test kits",
          "labelVi": "Bộ xét nghiệm nhanh sốt xuất huyết"
        },
        {
          "id": "mosquito-control",
          "label": "Mosquito nets / repellent",
          "labelVi": "Màn chống muỗi / thuốc xua"
        },
        {
          "id": "thermometer",
          "label": "Thermometers",
          "labelVi": "Nhiệt kế"
        }
      ],
      "recommendedAction": "Increase dengue rapid tests, ORS, and antipyretics for HCMC catchment; brief district stores within 24h.",
      "newestEvidenceAt": "2026-07-30T04:12:00.000Z"
    }
  ],
  "regions": [
    {
      "code": "HCM",
      "name": "Ho Chi Minh City",
      "nameVi": "TP.HCM",
      "disease": "Dengue",
      "evidenceScore": 58,
      "severity": "elevated",
      "etaDays": 8
    }
  ],
  "meta": {
    "signalsConsidered": 42,
    "watchesConsidered": 6,
    "alertsReturned": 1
  }
}