លក្ខខណ្ឌសេវាកម្ម API

លក្ខខណ្ឌ API ទាំងនេះគ្រប់គ្រងការចូលប្រើ API សាធារណៈរបស់ InKhmer តាមរបៀបស្វ័យប្រវត្តិ — ចាប់ផ្តើមដោយ API បកប្រែឯកសារ AI នៅ /v1/public/document-translator។ ពួកវាបំពេញលក្ខខណ្ឌសេវាកម្មទូទៅ។ ប្រសិនបើមានភាពខុសគ្នា លក្ខខណ្ឌ API ទាំងនេះមានអានុភាពសម្រាប់ការប្រើប្រាស់ API។ ការប្រើគេហទំព័រធម្មតាមិនចាំបាច់ទទួលយកឯកសារនេះទេ។

ការចូលប្រើ API តម្រូវឱ្យមានកូនសោ TosKey ដែលចេញតាម TosKey Console (S5 → InKhmer)។ កូនសោមានស្កុប — translator:translate។ translator:read និង translator:cancel — ហើយរាល់សំណើ ត្រូវផ្ញើកូនសោជា Bearer token។

1. រក្សាកូនសោឱ្យសម្ងាត់។ សកម្មភាពក្រោមកូនសោរបស់អ្នកគឺជាការទទួលខុសត្រូវរបស់អ្នក។
2. ប្តូរកូនសោភ្លាមៗប្រសិនបើវាអាចលេចធ្លាយ ហើយប្រើកូនសោ sk_test_ សម្រាប់ការអភិវឌ្ឍ និង CI។
3. កុំចែករំលែកកូនសោរវាងអង្គភាព ឬលក់ការចូលប្រើ API ឡើងវិញ។

ការងារ API គិតជាក្រេឌីតបង់មុន ដកពីកាបូបនៅពេលបង្កើតការងារ តាមតារាងតម្លៃក្នុងមួយទំព័រដែលបានបោះពុម្ព។

1. ការដកប្រាក់មានលក្ខណៈ idempotent — Idempotency-Key ដដែលម្តងទៀតឆ្លើយតបជាមួយលទ្ធផលដើម ដោយមិនដកប្រាក់ពីរដង។
2. ការងារដែលបរាជ័យមុនបញ្ចប់ត្រូវសងក្រេឌីតវិញដោយស្វ័យប្រវត្តិ។
3. ការងារដែលអ្នកបោះបង់ត្រូវសងសម្រាប់ទំព័រដែលមិនទាន់បានបកប្រែ។
4. ក្រេឌីតមិនអាចផ្ទេរ ឬប្តូរជាសាច់ប្រាក់បានទេ។ សមតុល្យកាបូបអនុវត្តតាមគោលការណ៍សងប្រាក់ទូទៅ។

ដែនកំណត់អត្រាក្នុងមួយកូនសោ និងក្នុងមួយគណនីត្រូវអនុវត្តនៅ gateway។ សំណើដែលលើសកំណត់ទទួល 429 ជាមួយ Retry-After និងបឋមកថា X-RateLimit-* — កម្មវិធីរបស់អ្នកត្រូវគោរព។

1. កុំប្តូរកូនសោជុំវិញដើម្បីឈានលើសកំណត់។
2. សមត្ថភាព burst លើសកំណត់ស្តង់ដារតម្រូវជានិវ៉ាន់ដែលអាប់ផែតទ័រកំណត់ — ទាក់ទងយើងដើម្បីស្នើ។
3. ការរំលោភដែនកំណត់ម្តងហើយម្តងទៀតអាចនាំឱ្យការបញ្ឈប់កូនសោបណ្តោះអាស្រ័យ បន្ទាប់ពីការជូនដំណឹង។

អ្នកអាចដាក់ស្នើតែឯកសារដែលអ្នកមានសិទ្ធិដំណើរការ។ អ្នកមិនត្រូវប្រើ API ដើម្បី៖

1. ដំណើរការខ្លឹមសារដែលខុសច្បាប់ រំលោភកម្មសិទ្ធិ ឬឯកជនភាពភាគីទីបី;
2. ស្វែងរក ស្កែន ឬវាយប្រហារសេវាកម្ម ឬដែនកំណត់អត្រារបស់វា;
3. ប្រែក្លាយប្រភពនៃសំណើ ឬក្លែងបន្លំបឋមកថាអត្តសញ្ញាណ;
4. ស្រង់ ឬកសាងម៉ាស៊ីនបកប្រែខ្លួនវាឡើងវិញ។

ឯកសារដើមដែលបានផ្ទុកឡើងត្រូវរក្សាទុករហូតដល់ ២៤ ម៉ោង ហើយលទ្ធផលបកប្រែរហូតដល់ ៧ ថ្ងៃ បន្ទាប់មកវាត្រូវលុប។ ទិន្នន័យមេតានៃការងារ (ចំនួនទំព័រ កម្រិតតម្លៃ ស្ថានភាព) ត្រូវរក្សាទុកសម្រាប់ការគិតប្រាក់ និងការពិនិត្យការប្រើប្រាស់ខុស។

1. អត្ថបទឯកសារមិនត្រូវចែករំលែកទៅអតិថិជនដទៃ ឬប្រើក្នុងលទ្ធផលសាធារណៈទេ។
2. ការពិនិត្យរបស់អាជ្ញាធរ (admin) បង្ហាញតែមេតាទេតាការងារ — ខ្លឹមសារឯកសារមិនបង្ហាញក្នុងផ្ទាំងគ្រប់គ្រងទេ។
3. អ្នកទទួលខុសត្រូវលើភាពស្របច្បាប់នៃឯកសារដែលអ្នកដាក់ស្នើ។

ការងារ API ដែលបានបញ្ចប់ផ្តល់ PDF គ្មានទឹកស្នាម ដែលអាចទាញយកតាម /pdf របស់ការងារ។ អ្នកទទួលអាជ្ញាបណ្ណអចិន្ត្រៃយ៍ ដើម្បីប្រើលទ្ធផលបកប្រែសម្រាប់គោលបំណងស្របច្បាប់ណាមួយ។ យើងមិនរក្សាសិទ្ធិលើខ្លឹមសារឯកសាររបស់អ្នកទេ។

API សាធារណៈផ្តល់តាមគោលការណ៍ best-effort ដោយគ្មាន SLA សម្រាប់ការដំណើរការជាប់លាប់ក្នុងជំនាន់ v1។ ការផ្លាស់ប្តូរដែលបំបែក ត្រូវបោះពុម្ពក្រោមផ្លូវជំនាន់ថ្មី ជាមួយសេចក្តីជូនដំណឹងមុនលើផ្លូវអ្នកអភិវឌ្ឍ។ ការបន្ថែមដែលមិនបំបែកអាចចេញដោយគ្មានសេចក្តីជូនដំណឹង។ គ្មាន webhook ក្នុង v1 — poll ចំណុចការងារដើម្បីមើលស្ថានភាព។

ការប្រើប្រាស់មិនធម្មតា — ឧទាហរណ៍ ចំនួនការងារខ្ពស់ជាប់លាប់ជាមួយអត្រាកំហុសខ្ពស់ — បណ្តាលឱ្យមានការពិនិត្យរបស់អាប់ផែតទ័រ។ យើងអាចផ្អាក ឬដកកូនសោសម្រាប់ លឫធ្វើក្លែម ការប្រើប្រាស់ខុស ហានិភ័យសុវត្ថិភាព ឬការរំលោភលក្ខខណ្ឌទាំងនេះ ហើយនឹងជូនដំណឹងដល់ម្ចាស់គណនីពេលកូនសោត្រូវដក។ អ្នកអាចបញ្ឈប់ការប្រើ API គ្រប់ពេល។ ក្រេឌីតដែលនៅសល់អនុវត្តតាមគោលការណ៍សងប្រាក់។

ក្នុងវិសាលភាពដែលច្បាប់អនុញ្ញាត ការទទួលខុសត្រូវសរុបរបស់ InKhmer សម្រាប់ ការទាមទារ API ត្រូវកំណត់នៅក្រេឌីតដែលអ្នកបានទិញក្នុង ៩០ ថ្ងៃមុនការទាមទារ។ API ត្រូវផ្តល់ "ដូចដែលវាមាន" ដោយគ្មានការធានានៃការដំណើរការគ្មានរារាំង។ សំណួរ៖ info@inkhmer.com។