Public API Reference — Hantavirus

Gambaran keseluruhan

Hantavirus.app menyediakan API awam, baca sahaja untuk akses programatik kepada data wabak. API dibina di atas tRPC dan boleh diakses di https://api.hantavir.us.com/api/trpc.

Pengesahan

API awam adalah tanpa pengesahan. Semua prosedur baca tersedia tanpa kunci API.

Had kadar

60 permintaan seminit setiap alamat IP
Pengepala had kadar disertakan dalam respons: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Melebihi had mengembalikan 429 Too Many Requests

Penghala tRPC

Penghala	Prosedur utama	TTL cache
`outbreak.*`	getCurrent, getBySlug, list, getRiskLevel	30s
`cases.*`	getCounts, getTimeSeries	30s
`regions.*`	list, byCountry	60s
`news.*`	list, getById	Tiada
`timeline.*`	list	60s (halaman pertama)
`faqs.*`	list	Tiada
`advisories.*`	list, byCountry	Tiada
`ticker.*`	list	10s

Dokumentasi prosedur lengkap tersedia dalam rujukan API dalaman.

Titik akhir REST

Untuk keselesaan, kami juga menyediakan pembungkus REST:

Titik akhir	Kaedah	Penerangan
`/v1/outbreak/:slug`	GET	Dapatkan pengepala wabak mengikut slug
`/v1/outbreaks`	GET	Senaraikan semua wabak aktif
`/v1/cases/:slug`	GET	Dapatkan jumlah kes untuk wabak

Server-Sent Events (SSE)

Strim	Penerangan	Peristiwa
`/sse/ticker`	Kemas kini ticker berita langsung	text, severity, link
`/sse/ships/:mmsi`	Kemas kini kedudukan kapal	lat, lng, speed, heading

Contoh: ticker SSE

const source = new EventSource('https://api.hantavir.us.com/sse/ticker');
source.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log(data.text, data.severity);
};

Sokongan tempatan

Semua prosedur yang sedar tempatan menerima bahasa melalui:

kuki hv-locale
pengepala Accept-Language
Lalai: en

Disokong: en, ar (Gulf Khaleeji), fr

Untuk butiran API penuh, lihat dokumentasi API lengkap.