Ul API hep kemmadur hag un API gant fall a blij da dreiñ en doareoù disheñvel. Un enklask gant buhez a c'hall bezañ hep mont da garti e lec'hoù difennet. Ur fall roued, ur harzoù pe ur servij didaet a seul eus neuze n'eus ket disoc'h gant an enklask.
E ROOTE kontrolit an treuzkast HTTP ha goude stad micherel, ar c'heriaoueg e sak ha kouvad an displegadenn. Al labour-se a ziskouez din hag e ranker mont en-dro d'ar goulenn evit 'n ober gant e servijoù, rak ma'z a 'ta un doare fall pe n'eo ket gwelet perzhioù an tem zoken a c'hell bezañ amzer.
Lenn tri live ur respont
| Live | E kontrowailh | Kevredad a c'hallout kas anezhañ |
|---|---|---|
| Treuzkast | Keñveriañ, amzer e krog, ha stad HTTP | Esaou e oa ar goulenn ? |
| Kontell | JSON resis, an doare ha-maen da zerc'hel kont anezho | Emañ ar respont da implijout ? |
| Disoc'h micherel | stad, klevadoù, kouvad, santimantoù hag meta | Petra vez gouest da zizoloiñ e lec'h diversañ ? |
Ar kodi HTTP 200 n'eo ket re evit krediñ ur enklask. Ar respont a c'hall ober un taolm hag ur stad fall ankounac'haet. War a seurt arall, ur 404 war ul hent n'eo ket gwir evit diskouez ur ralladenn vide : gwiritekit URL ha kontell.
Compren success, empty, partial ha error
| Stad | Arbed etrezek |
|---|---|
| success | Diskouez an elfennioù goude gwiriadur ha dalvezout an harzoù |
| empty | Diskouez n'eus bet kemmadur viken e-barzh an enklask-mañ |
| partial | Diskouez an titouroù implijet gant o santimantoù |
| error | Diskouez an enklask evel didaet ; na tennet ket asant eus ar muiañ lec'hioù |
N'eus forzh pet kemmadur pe brezhoneg zo bet aozet evit kaout un disoc'h vide. Neou zevez ket e kompez ar servijoù o tont da beder. Ur gwel mat m'eo displijet e krog an arbedenn, un filtr strizh pe un harzoù ezhomm a c'hall lemel war-dro an disoc'hoù.
Ur skouer boltred evit da eus interface
1. La requête a-t-elle abouti ?
Non → indisponibilité réseau ou délai dépassé.
2. Le statut HTTP est-il acceptable selon le contrat ?
Non → traiter le code et le message d'erreur.
3. Le JSON respecte-t-il le schéma attendu ?
Non → réponse inexploitable, jamais "aucun résultat".
4. Le statut métier est-il error ?
Oui → recherche indisponible.
5. Le statut est-il partial ou la couverture limitée ?
Oui → résultats utilisables + avertissement.
6. La collection attendue est-elle vide ?
Oui → aucun résultat retourné dans ce périmètre.
Non → afficher les résultats et leurs limites.Gwiriit ar parametradoù e dermen
Gwriit a-raok latitudo hag lonjitudo, o ord hag ar gêr krouet. Gwiriañ an unvaniezh eus ar rain hag ar gerioù filtr. API Services a implij types=toilets ; ur URL kartez a implij modes=toilets. Ar parametradoù-se a zo eus kontelloù disheñvel.
Kempo rahañ ur pezhennenn pemdez war-zu un hevelep an amzer-se : soraat ar rain er c'hounadaouiñ pe kas kuit un filtr evit enklask davedek. Mirout ar skeudenn eus ar goulenn orin. Ma kreskoc'h e lein ar goloch, lavarit d'an implijer an trev dija.
Sevel ur enklask API war-zu koordinened GPS
Embann servij didaet hep kollet an eil
Un respont divis a c'hall ober gant lec'hioù o tont eus servijoù en em gav. Dalvezit an disoc'hoù-se ha o maezadoù, hag an digresk estrenn. Na tiskouez ket an roll evel pinvidik ha n'en grogit ket gant degouezhioù kozh.
Ur goulennoù kozh eno ha dleet e-barzh ar c'hachel a c'hall bezañ talvoudus ma'z eus ur politik KOCH da reiñ ar memez ampennemant. Ret eo anezhi chom lakaet evel kozh. Amzer derc'hel eus da goulenn n'eo ket eñvor an dianav war-dro ar c'hentañ temadur.
Kemmañ an dibarioù hag ar renadoù
| Darvoudoù | Kemmadur da gemmañ evit da interface | Oberiadur |
|---|---|---|
| empty | N'eus bet kemmadur nemet e lec'h-mañ gant ar filtrañ-mañ | Cheñch an dachenn pe an filtrañ |
| partial | Breudeur a zo war-eeun an enklask n'eo ket hollek | Diskouez an disoc'hoù hag ar goulenn a-gostez |
| Fall en verifikadur | Ar goulenn en e-barzh ez eus un parametr fall | Cheñch ar goulenn |
| Aotreoù pe gwirioù | N'eo ket ar c'huzul ma'z eus goulennet-se | Gwiriit da enklask pe da barn |
| Harzoù pe didaet | Ar goulenn n'eo ket tro da vezañ displeget | Uhel-kemeriet ar c'helennadurioù |
Evit ur 429, sellit ouzh ar c'helennadurioù servijoù hag an Retry-After e c'hallfe bezañ bet kresket. Un fall 400 a c'hall kaout un adkoulenn ar goulenn ; adkrouiñ ur goulenn nemet e c'hell ket hor gomz. Na cheñch ket ur 401 d'ur goulenn denel e-giz emañ ur token war-lerc'h da gaout an implijer.
Dianav ar pevar stad a-raok kas pell
Pregetañ disoc'hoù eo komplek, vide, rannvro ha fall, kement ha JSON fall ha harzoù tremenet. Gwiriañ ar c'heriadur diskouezet, an disoc'hoù dalvezus, ha niverenn an ali. Ar c'hontrol eus pouezus a zo ma n'eo ket ur fall en deus diskouez netra eus servijoù.
Lezel an aloubidigezhioù-se d'un sikouriad AI
Arouez an roadennoù-stumm kemmadur vagdañserien
Goulennou-kouman
Un roll vide a ziskouez n'eus ket tostlafriedail ?
Nann. Diskouez e oa ket kemmadur e-barzh an enklask-se ha er servijoù.
Da c'hallfe diskouez ur respont rannvro?
Ya, ma'z eo an elfennou implijet reizh ha ma talvoudat ar santimantoù hag an harzoù a-bouez.
Eprezhañ pep fall ?
Nann. Cheñch ar falloù parametr pe ar gwirioù ; pellit ar gotaou war an doaread an denel ha doulezit ar c'helennoù servijoù.