មគ្គុទេសក៍ផ្ទេរ API - ធ្វើរោគរាតត្បាតរវាងកំណែ

ទិដ្ឋភាពទូទៅនៃការផ្ទេរ

Smart Money API ត្រូវបានអភិវឌ្ឍយ៉ាងសកម្មជាមួយនឹងការអាប់ដេតជាប្រចាំ។ មគ្គុទេសក៍នេះគ្របដណ្តប់លើការគ្រប់គ្រងកំណែ ការផ្លាស់ប្តូរដែលបំផ្លាញ និងរបៀបផ្ទេរការរួមបញ្ចូលរបស់អ្នកដោយគ្មានពេលរងចាំ។

គោលការណ៍សំខាន់នៃការផ្ទេរ៖

• កំណែសេម៉ាន់ទិក — ទម្រង់ MAJOR.MINOR.PATCH ត្រូវបានអនុវត្តយ៉ាងតឹងរ៉ឹង
• ការគាំទ្រពេលវេលាយូរ — កំណែចម្បងមុនត្រូវបានគាំទ្រអស់ពេល 24+ ខែ
• ការព្រមានលុបចោល — ប្រាប់មុន 6 ខែអំពីការផ្លាស់ប្តូរដែលបំផ្លាញទាំងអស់
• កំណែស្របគ្នា — ដំណើរការ v1 និង v2 ក្នុងពេលតែមួយក្នុងអំឡុងពេលផ្ទេរ
• ការធ្វើតេស្តស្វ័យប្រវត្តិ — ផ្តល់ឧបករណ៍ភាពឆបគ្នានៃក្រុមតេស្ត

គោលនយោបាយកំណែ

កំណែសេម៉ាន់ទិក

វដ្តចេញផ្សាយកំណែ

ភាពឆបគ្នាថយក្រោយ

ភាពឆបគ្នានៃកំណែ

ក្នុងកំណែចម្បងមួយ អ្នកអាចធ្វើរោគរាតត្បាតទៅកំណែអនីតិជន/បំណះថ្មីៗដោយសុវត្ថិភាព៖

• URL Endpoint — នៅតែមិនផ្លាស់ប្តូរ
• វាលដែលត្រូវការ — មិនដែលត្រូវបានយកចេញ (មានតែវាលជាជម្រើសថ្មីត្រូវបានបន្ថែម)
• កូដស្ថានភាព HTTP — ត្រូវបានរក្សាទុកសម្រាប់សេណារីយ៉ូដែលមានស្រាប់
• រចនាសម្ព័ន្ធចម្លើយ — វាលគោលនៅតែដូចគ្នា
• ការផ្ទៀងផ្ទាត់ — គ្មានការផ្លាស់ប្តូរទៅយន្តការផ្ទៀងផ្ទាត់

ការលុបចោលដោយសុភាពរាបសា

ការផ្ទេរពី V1 ទៅ V2

ការផ្លាស់ប្តូរចម្បងៗ

• ការរចនា API REST ឡើងវិញ — Endpoint ធនធានដែលស្អាតជាង
• ទម្រង់ចម្លើយ — ការរុំដែលស៊ីសង្វាក់គ្នា ការគ្រប់គ្រងកំហុសល្អប្រសើរជាង
• ការផ្ទៀងផ្ទាត់ — បានបន្ថែមការគាំទ្រ OAuth 2.0 (សោរ API នៅតែដំណើរការ)
• ការកំណត់អត្រា — ភាពលម្អិត និងភាពច្បាស់លាស់ប្រសើរជាង
• Webhooks — ទម្រង់ព្រឹត្តិការណ៍ និងការចុះហត្ថលេខាដែលបានរចនាឡើងវិញ

ការគូសផែនទី Endpoint

ការផ្លាស់ប្តូរ Endpoint

ការផ្លាស់ប្តូរប៉ារ៉ាម៉ែត្រសំណើ

ការអាប់ដេតទម្រង់ចម្លើយ

រចនាសម្ព័ន្ធចម្លើយ V1

រចនាសម្ព័ន្ធចម្លើយ V2

ភាពខុសគ្នាសំខាន់៖ គ្មានស្រោម status ឈ្មោះវាលកាន់តែច្បាស់ ទិន្នន័យមេតាស្តង់ដារ។

ពេលវេលាដកចេញ

ការដកចេញដែលបានគ្រោងទុក

ព័ត៌មានលម្អិតអំពីការផ្លាស់ប្តូរដែលបំផ្លាញ

ចំណុចបញ្ចប់ដែលបានដកចេញ

• /v1/stats — ត្រូវបានជំនួសដោយ /v2/metrics
• /v1/historical — ត្រូវបានជំនួសដោយ /v2/historical ជាមួយប៉ារ៉ាម៉ែត្រថ្មី
• /v1/alerts/create — ត្រូវបានជំនួសដោយ POST /v2/alerts

ការផ្លាស់ប្តូរប៉ារ៉ាម៉ែត្រ

• limit — លំនាំដើមបានផ្លាស់ប្តូរពី 100 ទៅ 20 (ច្បាស់លាស់!)
• timeframe — ឥឡូវត្រូវការលើការស្វែងរយៈពេលប្រវត្តិសាស្ត្រ
• sort — ទម្រង់បានផ្លាស់ប្តូរពី "field asc" ទៅ "field:asc"

ការផ្លាស់ប្តូរវាលចម្លើយ

• funding → funding_rate
• price → mark_price
• vol → volume_quote

ការផ្លាស់ប្តូរជាជំហានៗ

ដំណាក់កាលទី 1: ការរៀបចំផែនការ (សប្តាហ៍ 1-2)

1. ត្រួតពិនិត្យការរួមបញ្ចូលដែលមានស្រាប់សម្រាប់លក្ខណៈពិសេសដែលបានដកចេញ
2. គូសផែនទីចំណុចបញ្ចប់ v1 ទៅជាគូសមមូល v2
3. កំណត់អត្តសញ្ញាណការផ្លាស់ប្តូរដែលបំផ្លាញដែលប៉ះពាល់ដល់កូដរបស់អ្នក
4. រៀបចំយុទ្ធសាស្ត្រការធ្វើតេស្ត និងពេលវេលា

ដំណាក់កាលទី 2: ការអភិវឌ្ឍន៍ (សប្តាហ៍ 3-4)

1. បង្កើតសាខា v2 ក្នុងការគ្រប់គ្រងកំណែ
2. ធ្វើបច្ចុប្បន្នភាពចំណុចបញ្ចប់ API ទាំងអស់ទៅ URL v2
3. ធ្វើបច្ចុប្បន្នភាពការដោះស្រាយសំណើ/ចម្លើយ
4. រត់តេស្តឯកតាប្រឆាំងនឹងប្រអប់ខ្សាច់

ដំណាក់កាលទី 3: ការធ្វើតេស្ត (សប្តាហ៍ 5-6)

1. រត់ការធ្វើតេស្តរួមបញ្ចូលពេញលេញ
2. សាកល្បងស្ថានភាពកំហុស និងករណីគែម
3. ការធ្វើតេស្តបន្ទុកជាមួយចំណុចបញ្ចប់ v2
4. ការត្រួតពិនិត្យសុវត្ថិភាពនៃកូដដែលបានធ្វើបច្ចុប្បន្នភាព

ដំណាក់កាលទី 4: ដំណាក់កាល (សប្តាហ៍ 7)

1. ដាក់ចេញកូដ v2 ទៅកាន់បរិស្ថានដំណាក់កាល
2. រត់ការធ្វើតេស្តទទួលយកពេញលេញ
3. ទទួលបានការចុះហត្ថលេខាពីភាគីពាក់ព័ន្ធ
4. រៀបចំផែនការត្រឡប់ក្រោយ

ដំណាក់កាលទី 5: ផលិតកម្ម (សប្តាហ៍ 8)

1. ការដាក់ចេញពណ៌ខៀវ-បៃតងទៅផលិតកម្ម
2. តាមដានវាស់វែង និងអត្រាកំហុស
3. នៅលើការហៅសម្រាប់បញ្ហាគាំទ្រ
4. ដកចេញកូដ v1 ជាបន្តបន្ទាប់

ការគាំទ្រ និងធនធាន

ឧបករណ៍ដែលមាន

• កម្មវិធីផ្ទៀងផ្ទាត់ការផ្លាស់ប្តូរ — ពិនិត្យកូដសម្រាប់ការប្រើប្រាស់ដែលបានដកចេញ
• កម្មវិធីពិនិត្យធ្វើឱ្យប្រសើរ API — ប្រៀបធៀបភាពឆបគ្នារវាង v1 និង v2
• បញ្ជីពិនិត្យការផ្លាស់ប្តូរ — ឯកសារ PDF ដែលមានភារកិច្ច និងពេលវេលា
• ឧទាហរណ៍កូដ — គំរូមុន/ក្រោយការផ្លាស់ប្តូរ

ការទទួលជំនួយ

• អ៊ីមែល: [email protected]
• ឯកសារ: មើល changelog-versioning.html
• Discord: ឆានែលគាំទ្រសហគមន៍
• សហគ្រាស: វិស្វករផ្លាស់ប្តូរដែលមានភារកិច្ច