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

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

Source: https://www.roote.ai/km/guides/%E1%9E%82%E1%9F%92%E1%9E%98%E1%9E%B6%E1%9E%93%E1%9E%9B%E1%9E%91%E1%9F%92%E1%9E%92%E1%9E%95%E1%9E%9B-%E1%9E%AC%E1%9E%80%E1%9F%86%E1%9E%A0%E1%9E%BB%E1%9E%9F-api-%E1%9E%8F%E1%9E%BE%E1%9E%92%E1%9F%92%E1%9E%9C%E1%9F%81%E1%9E%B8%E1%9E%94%E1%9F%82%E1%9E%94%E1%9E%8E%E1%9E%B6-%E1%9E%8A%E1%9E%B9%E1%9E%84%E1%9E%97%E1%9E%B6%E1%9E%96%E1%9E%81%E1%9E%BB%E1%9E%9F%E1%9E%82%E1%9F%92%E1%9E%93%E1%9E%B6/
Language: km
Author: ROOTE

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](https://www.roote.ai/km/guides/%E1%9E%92%E1%9F%92%E1%9E%9C%E1%9E%BE%E1%9E%8A%E1%9E%BC%E1%9E%85%E1%9E%98%E1%9F%92%E1%9E%8F%E1%9F%81%E1%9E%85%E1%9E%8A%E1%9E%BE%E1%9E%98%E1%9F%92%E1%9E%94%E1%9E%B8%E1%9E%9F%E1%9F%92%E1%9E%9C%E1%9F%82%E1%9E%84%E1%9E%9A%E1%9E%80%E1%9E%87%E1%9E%B6%E1%9E%82%E1%9E%93%E1%9F%92%E1%9E%9B%E1%9E%84%E1%9E%8A%E1%9E%B9%E1%9E%80%E1%9E%87%E1%9E%89%E1%9F%92%E1%9E%87%E1%9E%BC%E1%9E%93%E1%9E%93%E1%9F%85%E1%9E%87%E1%9E%B7%E1%9E%8F%E1%9E%94%E1%9E%93%E1%9F%92%E1%9E%91%E1%9E%B6%E1%9E%94%E1%9F%8B%E1%9E%96%E1%9E%B8%E1%9E%80%E1%9E%B6%E1%9E%9A%E1%9E%94%E1%9F%92%E1%9E%9A%E1%9E%BEapi/)

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

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

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

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

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

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

[យោងកំហុស API ROOTE](https://doc.roote.ai/roote-api/errors)

[ស្ថានភាពសេវាកម្ម ROOTE](https://status.roote.ai/)

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

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

[អនុវត្តច្បាប់ទាំងនេះទៅឧបករណ៍ជំនួយ AI](https://www.roote.ai/km/guides/%E1%9E%92%E1%9F%92%E1%9E%9C%E1%9E%BE%E1%9E%87%E1%9F%86%E1%9E%93%E1%9E%BD%E1%9E%99%E1%9E%80%E1%9E%B6%E1%9E%9A%E1%9E%9F%E1%9F%92%E1%9E%9C%E1%9F%82%E1%9E%84%E1%9E%9A%E1%9E%80%E1%9E%85%E1%9E%9B%E1%9E%93%E1%9E%B6%E1%9E%98%E1%9E%87%E1%9E%BB%E1%9F%86%E1%9E%9C%E1%9E%B7%E1%9E%89%E1%9E%A2%E1%9E%B6%E1%9E%9F%E1%9E%99%E1%9E%8A%E1%9F%92%E1%9E%8B%E1%9E%B6%E1%9E%93/)

[យល់ដឹងពីទ្រង់ទ្រាយទិន្នន័យចលនា](https://www.roote.ai/km/guides/gtfs-gtfs-rt-et-gbfs-munh-chea-daut-ol-roeut/)

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

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

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

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

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

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

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