ទំព័រដើម/មគ្គុទេសក៍/អ្នកអភិវឌ្ឍន៍
អ្នកអភិវឌ្ឍន៍

គ្មានលទ្ធផល ឬកំហុស API៖ តើធ្វេីបែបណា ដឹងភាពខុសគ្នា?

ចែងខុសគ្នារវាងលទ្ធផលទទេ ការឆ្លើយតបផ្នែកមិនពេញលេញ និងកំហុស API ROOTE។ ពិនិត្យទីតាំង ស្វ័យត្រួតពិនិត្យ និងដែនកំណត់សម្រាប់បង្ហាញ​សារ​ត្រឹមត្រូវ។

By ROOTE·អានរយៈពេល 7 នាទី
គ្មានលទ្ធផល ឬកំហុស API៖ តើធ្វេីបែបណា ដឹងភាពខុសគ្នា?
ចម្លើយទទេមិនមែនជាការបរាជ័យទេ។

ព័ត៌មានសំខាន់ក្នុងរយៈពេលប៉ុន្មានវិនាទី

ចាប់ផ្ដើមពីការ​ដឹកជញ្ជូន HTTP បន្ទាប់មកផ្ទៀងផ្ទាត់មាតិកា និងស្ថានភាពអាជីព។ ការស្វែងរកទទេមិនមែនជាការបរាជ័យទេ។ ការបរាជ័យមិនសម្តែងការខ្វះសេវាកម្មទេ។ ចម្លើយមិនពេញលេញអាចប្រើបានជាមួយការជូនដំណឹង។

API ដែលគ្មានលទ្ធផល និង API ដែលមានកំហុសតម្រូវឲ្យមានការដោះស្រាយផ្សេងៗគ្នា។ ការស្វែងរកជោគជ័យ អាចមិនបង្ហាញទីតាំងណាមួយនៅក្នុងដែនដីដែលបានសួរ។ កំហុស​បណ្តាញ កេីតដែនកំណត់ ឬប្រភពមិនអាចប្រើបាន ធ្វើឲ្យមិនអាចសន្និដ្ឋានពីការស្វែងរកបាន។

សម្រាប់ ROOTE សូមត្រួតពិនិត្យចម្លើយ HTTP រួចមកស្ថានភាពអាជីព ការប្រមូលទិន្នន័យដែលគេរង់ចាំ និងដែនកំណត់។ វិធីនេះជួយបរិភោគច្បាស់ថា មិនចេញសារ «គ្មានបង្គន់» ពេលហៅសេវាកម្មបរាជ័យ ឬ «គ្មានឧបករណ៍សំរាក» បន្ទាប់ពីរង់ចាំលើសពេលវេលា។

អានកម្រិតបីនៃចម្លើយ

កម្រិតត្រូវត្រួតពិនិត្យការសន្និដ្ឋានដែលអាចធ្វើ
ការដឹកជញ្ជូនការតភ្ជាប់ ពេលវេលា និងស្ថានភាព HTTPសំណើបានបញ្ចប់ដោយជោគជ័យឬ?
កិច្ចសន្យាJSON ត្រឹមត្រូវ កំណែ និងវាលដែលបានរំពឹងចម្លើយអាចប្រើបានឬ?
លទ្ធផលអាជីពstatus, ប្រមូលទិន្នន័យ, ដែនកំណត់, ការព្រមាន និង metaតើត្រូវដឹងអ្វីខ្លះនៅក្នុងដែនបានស្នើ?

កូដ HTTP 200 មិនគ្រប់គ្រាន់សម្រាប់ផ្ទៀងផ្ទាត់ការស្វែងរកទេ។ ចម្លើយអាចបង្ហាញការប្រតិបត្ដិការផ្នែកមួយ ឬស្ថានភាពកំហុស។ ក្នុងខ្លួនវិញ 404 នៅលើផ្លូវមិនមែនជាវិធីធម្មតាសម្រាប់បង្ហាញប្រមូលទិន្នន័យទទេ៖ សូមពិនិត្យ URL និងកិច្ចសន្យា។

យល់ដឹងពី success, empty, partial និង error

ស្ថានភាពការបំរើផ្តល់ស្នើសុំ
successបង្ហាញអង្គភាពបន្ទាប់ពីផ្ទៀងផ្ទាត់ និងរក្សាកំណត់ខណ្ឌ
emptyបង្ហាញថា គ្មានលទ្ធផលសម្រាប់ការស្វែងរកនេះ
partialបង្ហាញព័ត៌មានដែលអាចប្រើបានជាមួយការព្រមាន
errorបង្ហាញថាការស្វែងរកមិនអាចប្រើបាន; កុំ​សន្និដ្ឋានថាគ្មានទីកន្លែង

ការមិនមានលទ្ធផលទាក់ទងនឹងសំណើ និងប្រភពដែលបានស្គាល់។ វាមិនបញ្ជាក់ថាគ្មានសេវាកម្មពិតប្រាកដ។ ដែនកំណត់មិនពេញលេញ ការតម្រងខ្លាំង ឬដែនកំណត់អាចកាត់បន្ថយលទ្ធផល។

ដើមចម្រាស់សំណុំសំរាប់ផ្ទាំងរបស់អ្នក

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.

ពិនិត្យប៉ារ៉ាម៉ែត្រនៅលំដាប់ត្រឹមត្រូវ

សូមពិនិត្យមុនលាតទឹក និងរយៈទទឹង តម្រៀបរបស់ពួកវា និងទីក្រុងដែលទទួលបាន។ បន្ទាប់មកពិនិត្យអង្គភាពរបស់ប្រាក់ទង់ និងពាក្យសំដីក្នុងការតម្រង។ API សេវាកម្មប្រើ types=toilets; តំណរផែនទីប្រើ modes=toilets។ ប៉ារ៉ាម៉ែត្រទាំងនេះស្ថិតនៅក្នុងកិច្ចសន្យាផ្សេង។

ពង្រីកទំហំតែមួយនៅក្នុងពេលមួយ៖ បន្ថែមរយៈទទឹងនៅក្នុងដែនដីផ្លូវ ឬដកការតម្រងមួយចេញសម្រាប់សាកល្បងច្បាស់។ រក្សាទុកការស្នើដើម។ ប្រសិនបើពង្រីកដោយស្វ័យប្រវត្តិ សូមប្រាប់ដែនថ្មីទៅអ្នកប្រើ។

បង្កើតការស្វែងរក API ជុំវិញទីតាំង GPS

ដោះស្រាយប្រភពមិនអាចប្រើបានដោយមិនបាត់បង់ផ្សេងទៀត

ចម្លើយផ្នែកមួយអាចផ្ទុកទីតាំងពីប្រភពដែលបានឆ្លើយ ខណៈដែលមួយផ្សេងបរាជ័យ។ រក្សាលទ្ធផលទាំងនេះ ការផ្ដល់ផ្លូវ និងការព្រមានដែលពាក់ព័ន្ធ។ កុំបង្ហាញបញ្ជីដូចជាផ្ទាល់ខ្លួន ហើយកុំបំលែងវាលខ្វះជាតម្លៃលំនាំដើមដែលប៉ុលកប្បាស។

ព័ត៌មានចាស់ដែលរក្សា​នៅក្នុងប្រព័ន្ធឃ្លាំងអាចមានប្រយោជន៍ប្រសិនបើគោលនយោបាយអនុញ្ញាត។ វាត្រូវតែចែងថា ជាព័ត៌មានចាស់។ ពេលទទួលសំណើរបស់អ្នកមិនធ្វើឲ្យការសង្កេតឯកសារដើមវិលមកវិញឡើយ។

ប្ដូរសារនិងការទទួលស្នើសុំឡើងវិញ

ស្ថានភាពសារដើម្បីបដិសេធនៅផ្ទាំងរបស់អ្នកសកម្មភាព
emptyគ្មានលទ្ធផលត្រឡប់មកវិញនៅតំបន់នេះជាមួយតម្រងទាំងនេះប្ដូរតំបន់ ឬការតម្រង
partialលទ្ធផលខ្លះមាន; ការស្វែងរកមិនពេញលេញបង្ហាញលទ្ធផល និងសារព្រមាន
កំហុសផ្ទៀងផ្ទាត់ការស្វែងរកមានប៉ារ៉ាម៉ែត្រមិនត្រឹមត្រូវកែសម្រួលសំណើ
ការផ្ទៀងផ្ទាត់ឯកសារឬសិទ្ធិការចូលប្រើនេះមិនអនុញ្ញាតឲ្យស្វែងរកនេះពិនិត្យគណនី ឬសំបុត្រចូល
ដែនកំណត់ ឬមិនអាចប្រើបានការស្វែងរកមិនអាចប្រើបានបណ្ដោះអាសន្នគោរពនូវការណែនាំសម្រាប់ធ្វើឡើងវិញ

សម្រាប់កូដ 429 សូមពិនិត្យដំណឹងសេវាកម្ម និងភាគហ៊ុន Retry-After ប្រសិនបើមាន។ កំហុស 400 តម្រូវការកែប្រែអាគុយម៉ង់។ ការធ្វើសំណើម្តងទៀតមិនដោះស្រាយ។ កុំបម្លែងកំហុស 401 ទៅជា ហៅឆ្ងាយអនាមិកក្នុងករណីអ្នកប្រើបានផ្ដល់សំបុត្រ។

យោងកំហុស API ROOTE

ស្ថានភាពសេវាកម្ម ROOTE

សាកល្បងស្ថានភាពបួនមុនចេញផ្សាយ

រៀបចំចម្លើយសាកល្បងពេញលេញ ទទេ មិនពេញលេញ និងកំហុស ជាមួយ JSON មិនត្រឹមត្រូវ និងពេលវេលាយូរ។ ពិនិត្យសារបង្ហាញ លទ្ធផលបានរក្សា និងចំនួនធ្វើឡើងវិញ។ ការសាកល្បងសំខាន់ គឺ ការបរាជ័យមិនបញ្ចេញនូវការបញ្ជាក់ពីការខ្វះសេវាកម្ម។

អនុវត្តច្បាប់ទាំងនេះទៅឧបករណ៍ជំនួយ AI

យល់ដឹងពីទ្រង់ទ្រាយទិន្នន័យចលនា

សម្រាប់អ្នកអភិវឌ្ឍន៍កម្មវិធីក្រុមហ៊ុន ROOTE Mobility API

ចល័តភាពជុំវិញចំណុចមួយ។
ផ្ទាល់ក្នុងកម្មវិធីរបស់អ្នក។

  • ស្វែងរក
    ជុំវិញទីតាំងមួយ
  • ចូលដល់
    ទិន្នន័យចល័តភាព
  • ផ្សំក្នុង
    កម្មវិធីរបស់អ្នក

ផ្លាស់ពីផែនទីទៅទិន្នន័យ៖ ស្វែងរកចល័តភាពនិងសេវាកម្មជិតខាងជាមួយ ROOTE API។

សំណួរញឹកញាប់

តើបញ្ជីទទេបញ្ជាក់ថាគ្មានបង្គន់?

គ្មានទេ។ វាបង្ហាញតែថាគ្មានលទ្ធផលត្រលប់មកសម្រាប់ការស្វែងរកនិងប្រភពដែលបានសួរ។

តើអាចបង្ហាញចម្លើយមិនពេញលេញបានទេ?

បាន ប្រសិនបើអង្គភាពដែលប្រើមានសុពលភាព ហើយអ្នករក្សាការព្រមាន និងដែនកំណត់ត្រូវការ។

តើត្រូវធ្វើឡើងវិញរាល់កំហុសឬ?

គ្មាន។ ដោះស្រាយកំហុសប៉ារ៉ាម៉ែត្រឬការចូលប្រើ; កំណត់ការធ្វើឡើងវិញសម្រាប់បញ្ហានិរន្តរភាព និងគោរពដែនកំណត់សេវាកម្ម។

តើអ្នកកំពុងស្វែងរកអ្វីជុំវិញខ្លួនទេ?

ស្វែងរកតំបន់របស់អ្នកជាមួយ ROOTE ហើយរកព័ត៌មានដែលមានសម្រាប់រៀបចំដំណើររបស់អ្នក។

ស្វែងរកផែនទី ROOTE ↗