Emailema gabeko API bat eta API akats bat bi tratamendu desberdin eskatzen dute. Bilaketa arrakastatsu batek ez ditu inon kokapenik itzuli kontsultatutako eremuan. Sareko akatsa, muga bat gainditzea edo iturri bat ez egoteak bilaketatik ondorioztatzeari eragozten dio.
ROOTE-rako, egiaztatu lehendabizi HTTP erantzuna, ondoren negozio egoera, itxaroten den bilduma eta estaldura. Prozedura honek saihesten du «ez dago komunikatu» zerbitzu deialdi bat huts egin badu edo «ez dago geltokiik» itxarote denbora gainditu ondoren agertzea.
Irakurri erantzun baten hiru mailak
| Maila | Egiaztatu beharrekoa | Amesteko ondorioa |
|---|---|---|
| Garraioa | Konektibitatea, epea eta HTTP egoera | Eskaera lortu al da? |
| Hitzarmena | JSON balioduna, bertsioa eta beharrezko eremuak | Erantzuna erabilgarria al da? |
| Negozio emailea | egoera, bildumak, estaldura, ohartarazpenak eta meta | Zer dakigu eskatu den eremuan? |
HTTP 200 kode batek ez du bilaketa baliozkotu behar. Erantzunak atal erdi burutu bat edo errore egoera bat adierazi dezake. Bestalde, 404 batek bide baten gainean ez du bilketa huts baten modurik ohikoa adierazteko: egiaztatu URL eta hitzarmena.
Ulertu arrakasta, ezezaguna, partziala eta errorea
| Egoera | Tratamendu gomendatua |
|---|---|
| arrakasta | Balioztatuta erakutsi entitateak eta mugak gorde |
| ezezaguna | Adierazi bilaketak ez duela inolako emailerik itzuli |
| partziala | Erabili daitezkeen informazioak ohartarazpenekin erakutsi |
| errorea | Bilaketa eskuragaitzat aurkeztu; ez ondorioztatu kokapen faltarik dagoenik |
Emailerik ez egotea eskaria eta iturriak ezagunak badira gertatzen da. Ez du frogatzen zerbitzurik fisikoki existitzen ez denik. Estaldura osatu ezak, iragazki mugatzaileak edo aplikatutako mugak emaitzak murrizten ditu.
Zure interfazerako erabaki zuhaitza
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.Parametroak orden egokian egiaztatu
Lehenik eta behin latitude eta longitude kontrolatu, haien ordena eta lortutako hiria. Ondoren, erradioaren unitatea eta iragazkien hiztegia egiaztatu. Servicios API-k erabiltzen du types=toilets; mapa baten URL batek modes=toilets erabiltzen du. Parametro hauek hitzarmen desberdinetakoak dira.
Ondoren, zabaltzen joan norabide bakarrean: handitu erradioa bidearen mugaraino edo kendu iragazki bat probatzeko argiki. Gorde hutsegite hasierako eskaera. Automatikoki zabalduz gero, informatu erabiltzaileari eremu berria.
API bilaketa bat eraiki GPS koordenatuei buruz
Iturri bat ez dagoenean tratatu besteak galdu gabe
Erantzun partzial batek iturri batzuk erantzun duten kokapenak izan ditzake beste bat huts egin den bitartean. Emaitzak, egileak eta ohartarazpen egokia gorde. Ez erakutsi lista oso bezala eta ez ordezkatu falta diren eremuak balio ezegonkorekin.
Cache-an gordetako informazio zahar bat ere erabilgarria izan daiteke zure politika horrelako utzikeriak onartzen badu. Beti izan behar du identifikaturik zaharra dela. Eskaeraren jasotze orduak ez du itxurazko behaketa zaharra berritzen.
Mezuak eta erreprodukzioak moldatu
| Egoera | Zure interfazean moldatu beharreko mezua | Ekintza |
|---|---|---|
| ezezaguna | Eremu honetan ez dago emaitza bat iragazki hauekin | Aldatu eremua edo iragazkiak |
| partziala | Emaitza batzuk eskuragarri; bilaketa osatu gabea da | Erakutsi emaitzak eta ohartarazpena |
| Balioztapen akatsa | Bilaketak parametro baliogabe bat du | Zuzenketa egin eskaeran |
| Autentifikazioa edo baimenak | Sarbide honek ez du bilaketa hau onartzen | Kontua edo tokena egiaztatu |
| Muga edo eskuragaitasuna | Bilaketa momentuz eskuragaitza da | Erreprodukzio gidak jarraitu |
429-erako, zerbitzuaren argibideak eta Retry-Afters kontsultatu. 400 akats batek argumentuak zuzendu behar dira; eskaera berriak ez du arazorik konpontzen. Ez bihurtu 401 anonimo deialdi automatikora erabiltzaileak tokena eman badu.
ROOTE API akatsen erreferentzia
Argitaratu aurretik lau egoerak probatu
Prestatu probako erantzun osoak, hutsak, partzialak eta akatsak, baita JSON baliogabea eta epea gainditua. Egiaztatu mezua, emaitzak eta erreprodukzio kopurua. Probaketa garrantzitsua da huts eginak ez duela inoiz zerbitzurik ez dagoela baieztatzen.
Erlazionatu arau hauek AI laguntzaile batekin
Ulertu mugikortasun datuen formatuak
Maiz egiten diren galderak
Emailema hutsa komun falta adierazten al du?
Ez. Adierazten du soilik bilaketak eta iturriak ez duela emailerik itzuli.
Erantzun partzial bat erakutsi daiteke?
Bai, entitateak baliodunak badira eta ohartarazpen eta muga beharrezkoak gordetzen badituzu.
Errore bakoitza berrabiarazi behar da?
Ez. Parametro edo sarbide akatsak zuzendu; berrabiarazteak mugatu aldi baterako arazoentzat eta zerbitzuaren argibideak jarraitu.