TounenKijan aksè API a fonksyone
API piblik v1

Yon sèl aksè API pou done sekirite Ayiti.

Kit ou se yon devlopè, yon medya, yon ONG, yon biznis oswa yon ajans leta — se menm sistèm aksè a. Ou chwazi nivo ki kadre ak bezwen w, ou aplike, epi ou resevwa kle w.

Kle API

Kreye, sispann oswa efase kle w. Sekrè a parèt yon sèl fwa.

Limit vitès

60 rive 1200 demann pa minit selon nivo apwouve w la.

Lekti sèlman

POST, PUT ak DELETE refize (405) sof pou nivo ekri apwouve.

Nivo aksè yo

Chak nivo gen pwòp limit li, pwòp presizyon jeyografik li ak pwòp nivo verifikasyon li.

Tier 1 — Piblik / Obsèvatè

Blogè, etidyan, tablo debò piblik

Estatistik ajreje sèlman. Okenn kowòdone egzat, okenn detay ensidan endividyèl.

stats:read

Presizyon
Done ajreje sèlman
Limit
60 demann / min
Ekriti
Non — lekti sèlman
Verifikasyon
Verifikasyon senp
Re-revizyon
chak 365 jou
Tier 2 — Medya & Rechèch

Radyo, laprès, inivèsite, chèchè

Lis ensidan ak anyè biznis ak kowòdone flou (~500 m). Rapò idantite rete sele.

stats:readincidents:readbusinesses:readhospitals:read

Presizyon
Kowòdone flou (~500 m)
Limit
120 demann / min
Ekriti
Non — lekti sèlman
Verifikasyon
Dokiman legal obligatwa
Re-revizyon
chak 365 jou
Tier 3 — ONG operasyonèl

ONG, imanitè, sekirite operasyonèl

Tout lekti Tier 2 plis dwa pou soumèt rapò teren (incidents:write) ki pase nan file moderasyon an.

stats:readincidents:readbusinesses:readhospitals:readincidents:write

Presizyon
Kowòdone flou (~500 m)
Limit
300 demann / min
Ekriti
Wi (modere)
Verifikasyon
Dokiman legal obligatwa
Re-revizyon
chak 365 jou
Tier 4 — Sous ofisyèl

Lopital, ajans leta, sèvis ijans

Kowòdone egzat, dwa pou soumèt rapò, epi pouse alèt ofisyèl (alerts:write). Chak alèt mande yon konfimasyon imen anndan Vwazen.

stats:readincidents:readbusinesses:readhospitals:readalerts:readincidents:writealerts:write

Presizyon
Kowòdone egzat
Limit
600 demann / min
Ekriti
Wi (modere)
Verifikasyon
Verifikasyon an pèsòn
Re-revizyon
chak 180 jou
Tier 5 — Ijans nasyonal

Sant kowòdinasyon ijans, pwoteksyon sivil

Menm dwa ak Tier 4 ak pi gwo limit vitès, rezève pou kowòdinasyon ijans nasyonal.

stats:readincidents:readbusinesses:readhospitals:readalerts:readincidents:writealerts:write

Presizyon
Kowòdone egzat
Limit
1200 demann / min
Ekriti
Wi (modere)
Verifikasyon
Verifikasyon an pèsòn
Re-revizyon
chak 180 jou

Endpoint yo

GET/api/public/v1/stats

Estatistik ajreje pa depatman ak pa kategori ensidan.

stats:read

GET/api/public/v1/incidents

Lis ensidan aktif ak presizyon jeyografik selon nivo w la.

incidents:read

GET/api/public/v1/businesses

Anyè biznis verifye: non, kategori, zòn, orè.

businesses:read

GET/api/public/v1/hospitals

Anyè lopital: estati ijans, bezwen san ak kantite doktè an tan reyèl.

hospitals:read

Egzanp demann

curl -H "Authorization: Bearer vwz_live_xxx" \
  "https://vwazen.ht/api/public/v1/incidents?limit=25"

Vwazen pa anrejistre idantite moun ki rapòte a nan okenn fòm reveniran, menm anndan. Chak repons pase nan baryè anonimizasyon an: okenn idantite, kont, aparèy oswa kontak pa janm retounen, kèlkeswa nivo a.

Kijan pou aplike

1. Kreye yon kont

Enskri ak imel òganizasyon w lan, epi ale nan Entegrasyon ak API.

2. Soumèt aplikasyon w

Chwazi nivo a, esplike ka itilizasyon w, epi voye dokiman verifikasyon yo.

3. Revizyon ekip la

Ekip Vwazen egzamine chak dokiman epi ka mande plis enfòmasyon.

4. Kle ak sivi

Ou resevwa kle staging epi pwodiksyon, ak yon jounal itilizasyon konplè.

Sa pou w prepare anvan ou kreye kont

Men egzakteman chan fòm aplikasyon an mande. Ranmase yo davans — sitou nimewo anrejistreman an — pou w ranpli tout bagay yon sèl kou.

Non òganizasyon an

obligatwa

Non legal konplè jan l ekri nan papye anrejistreman an.

Tip òganizasyon

obligatwa

Medya, ONG, lopital, inivèsite, ajans leta oswa antrepriz.

Estati legal

obligatwa

Egzanp: ONG rekonèt pa MPCE, sosyete anonim, enstitisyon piblik.

Nimewo anrejistreman / NIF

obligatwa

Nimewo ki parèt sou sètifika anrejistreman oswa kat fiskal la.

Imel kontak ofisyèl

obligatwa

Yon imel domèn òganizasyon an — pa yon imel pèsonèl.

Kontak teknik

opsyonèl

Moun k ap entegre API a ak imel oswa telefòn li.

Sit entènèt

opsyonèl

Sit ofisyèl oswa paj rezo sosyal ki aktif.

Nivo aksè w mande

obligatwa

Tier 1 pou estatistik ajreje jiska Tier 5 pou aksè ofisyèl ijans.

Scope yo

obligatwa

stats:read, incidents:read, businesses:read — selon nivo a.

Ka itilizasyon

obligatwa

Esplike ki jan w pral sèvi ak done yo epi ki moun k ap wè yo.

Volim ou prevwa chak jou

opsyonèl

Yon estimasyon demann pa jou pou nou ka fikse limit la.

Akò itilizasyon done

obligatwa

Ou dwe aksepte akò a: pa gen re-idantifikasyon, pa gen revant done.

Dokiman pou Tier 2 ak plis

Sètifika anrejistreman • Nimewo fiskal / NIF • Pyès idantite reprezantan • Lèt otorizasyon • Politik pwoteksyon done

Règ ki pa negosyab

Idantite moun rete sele

  • Okenn nivo API pa janm resevwa non, kont, aparèy oswa telefòn yon moun ki rapòte.
  • Tout repons API pase nan yon baryè anonimizasyon anvan yo kite sèvè a.
  • Alèt ofisyèl (Tier 4-5) toujou mande yon konfimasyon imen anndan Vwazen.
  • Chak demann anrejistre; itilizasyon abizif fè kle a sispann otomatikman.

Akò itilizasyon done a

  • Okenn re-idantifikasyon: entèdi eseye jwenn ki moun ki rapòte yon ensidan.
  • Okenn revant done: ou pa ka vann, sede oswa redistribiye done yo bay yon twazyèm pati.
  • Re-verifikasyon peryodik: chak nivo mande yon nouvo kontwòl dokiman apre peryòd li a.
  • Atribisyon: site Vwazen lè w pibliye done oswa vizyalizasyon ki soti nan API a.