Magkaibang pangangailangan ang API na walang resulta kumpara sa API na may error. Maaaring walang maibalik na lugar ang matagumpay na paghahanap sa nasabing saklaw. Samantala, ang network error, nakaabot na limitasyon, o hindi magamit na source ay pumipigil sa konklusyon mula sa paghahanap.
Para sa ROOTE, suriin muna ang HTTP response pagkatapos ang business status, inaasahang koleksyon, at coverage. Nakakaiwas ito na magpakita ng “walang toilet” kapag nabigo ang Services call o “walang hintuan” pagkatapos lumampas ang timeout.
Basahin ang tatlong antas ng isang sagot
| Antas | Suriin | Posibleng konklusyon |
|---|---|---|
| Transport | Koneksyon, timeout at HTTP status | Naituloy ba ang request? |
| Kontrata | Valid na JSON, bersyon at inaasahang mga field | Magagamit ba ang sagot? |
| Business resulta | status, collections, coverage, warnings at meta | Ano ang nalalaman sa hinihiling na saklaw? |
Hindi sapat ang HTTP 200 para patunayan ang isang paghahanap. Maaaring may partial execution o error status ang sagot. Hindi normal na ipahayag ang empty collection gamit ang 404 sa ruta; suriin ang URL at kontrata.
Unawain ang success, empty, partial at error
| Status | Rekomendadong gawain |
|---|---|
| success | Ipakita ang mga entidad pagkatapos ng validasyon at panatilihin ang mga limitasyon |
| empty | Ipakita na walang resulta ang paghahanap na ito |
| partial | Ipakita ang magagamit na impormasyon kasama ang kanilang mga babala |
| error | Ipakita na hindi magagamit ang paghahanap; huwag konklusyunan ang kawalan ng mga lugar |
Ang kawalan ng resulta ay para sa panghiling at kilalang mga source. Hindi ito patunay na walang pisikal na serbisyo. Ang hindi kumpletong coverage, mahigpit na filter, o inilapat na limitasyon ay maaaring magpababa ng resulta.
Mapa ng desisyon para sa iyong 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.Suriin ang mga parameter sa tamang pagkakasunod
Suriing muna ang latitude at longitude, ang kanilang pagkakasunod at ang nabuong lungsod. Pagkatapos suriin ang unit ng radius at ang bokabularyo ng mga filter. Ginagamit ng Services API ang types=toilets; habang ang map URL ay gumagamit ng modes=toilets. Iba ang mga parametrong ito sa magkaibang kontrata.
Palawakin naman ang isang dimensyon lamang, tulad ng pagtaas ng radius sa loob ng ruta o tanggalin ang isang filter para sa tiyak na pagsubok. Itala ang orihinal na request. Kapag awtomatikong pinalawak, ipaalam sa gumagamit ang bagong saklaw.
Gawin ang API search gamit ang GPS coordinates
Hawakan ang hindi magagamit na source nang hindi nawawala ang iba
Maaaring maglaman ang partial response ng mga lugar mula sa mga source na tumugon habang ang isa ay nabigo. Panatilihin ang mga resulta, ang kani-kanilang attribution at ang angkop na babala. Huwag ipakita ang listahan na kumpleto at huwag palitan ang nawawalang mga field ng maling default na halaga.
Magagamit din ang lumang naka-cache na impormasyon kung pinapayagan ng iyong polisiya ito. Dapat ito ay matukoy bilang luma. Ang oras ng pagtanggap ng iyong request ay hindi nagpapabata sa orihinal na obserbasyon.
Iakma ang mga mensahe at retry
| Sitwasyon | Mensahe na iaakma sa iyong interface | Gawain |
|---|---|---|
| empty | Walang resulta sa lugar na ito gamit ang mga filter na ito | Baguhin ang lugar o mga filter |
| partial | May ilang resulta; hindi kumpleto ang paghahanap | Ipakita ang mga resulta at babala |
| Validation error | May invalid na parameter sa paghahanap | Ayusin ang request |
| Authentication o karapatan | Hindi pinapayagan ang paghahanap na ito sa access na ito | Suriin ang account o token |
| Limitasyon o hindi availability | Panandaliang hindi magagamit ang paghahanap | Sundin ang mga patnubay sa pag-retry |
Para sa 429, tingnan ang mga patnubay ng serbisyo at ang posibleng Retry-After. Ang error 400 ay nangangailangan ng pagwawasto sa arguments; hindi ito maresolba ng paulit-ulit na request. Huwag gawing automatic anonymous call ang 401 kung may ibinigay na token ang user.
Listahan ng mga error sa ROOTE API
Status ng mga serbisyo ng ROOTE
Subukan ang apat na estado bago i-publish
Maghanda ng kumpleto, empty, partial at error test responses, pati na rin ng invalid JSON at timeout. Suriin ang ipinakitang mensahe, ang mga panatilihing resulta at bilang ng pag-retry. Ang mahalaga ay huwag magpakita ng kawalan ng serbisyo kahit sa panahon ng pagkasira.
Ilapat ang mga patakarang ito sa AI assistant
Unawain ang mga mobility data format
Mga madalas itanong
Patunayan ba ng walang laman na listahan ang kawalan ng mga toilet?
Hindi. Ipinapakita lang nito na walang resulta ang nakuha mula sa paghahanap at mga source na sinaliksik.
Maipapakita ba ang partial response?
Oo, kung ang mga ginamit na entidad ay valid at pinananatili ang mga babala at kinakailangang limitasyon.
Kailangang ulitin ba ang bawat error?
Hindi. Ayusin ang mga error sa parameters o access; limitahan ang retries para sa pansamantalang insidente at sundin ang mga patnubay ng serbisyo.