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 ទៅជា ហៅឆ្ងាយអនាមិកក្នុងករណីអ្នកប្រើបានផ្ដល់សំបុត្រ។
សាកល្បងស្ថានភាពបួនមុនចេញផ្សាយ
រៀបចំចម្លើយសាកល្បងពេញលេញ ទទេ មិនពេញលេញ និងកំហុស ជាមួយ JSON មិនត្រឹមត្រូវ និងពេលវេលាយូរ។ ពិនិត្យសារបង្ហាញ លទ្ធផលបានរក្សា និងចំនួនធ្វើឡើងវិញ។ ការសាកល្បងសំខាន់ គឺ ការបរាជ័យមិនបញ្ចេញនូវការបញ្ជាក់ពីការខ្វះសេវាកម្ម។
អនុវត្តច្បាប់ទាំងនេះទៅឧបករណ៍ជំនួយ AI
យល់ដឹងពីទ្រង់ទ្រាយទិន្នន័យចលនា
សំណួរញឹកញាប់
តើបញ្ជីទទេបញ្ជាក់ថាគ្មានបង្គន់?
គ្មានទេ។ វាបង្ហាញតែថាគ្មានលទ្ធផលត្រលប់មកសម្រាប់ការស្វែងរកនិងប្រភពដែលបានសួរ។
តើអាចបង្ហាញចម្លើយមិនពេញលេញបានទេ?
បាន ប្រសិនបើអង្គភាពដែលប្រើមានសុពលភាព ហើយអ្នករក្សាការព្រមាន និងដែនកំណត់ត្រូវការ។
តើត្រូវធ្វើឡើងវិញរាល់កំហុសឬ?
គ្មាន។ ដោះស្រាយកំហុសប៉ារ៉ាម៉ែត្រឬការចូលប្រើ; កំណត់ការធ្វើឡើងវិញសម្រាប់បញ្ហានិរន្តរភាព និងគោរពដែនកំណត់សេវាកម្ម។