អត្ថបទនេះបកប្រែពីភាសាអង់គ្លេសដោយ AI។ អានអត្ថបទដើមជាភាសាអង់គ្លេស →
Python Banking API សម្រាប់អ្នកចាប់ផ្ដើមដំបូង៖ Flask + SQLite, ដាក់ប្រាក់ ដកប្រាក់ និងប្រវត្តិប្រតិបត្តិការ
បង្កើត banking REST API ជាមួយ Flask និង SQLite៖ មាន endpoint សម្រាប់គណនី ដាក់ប្រាក់ ដកប្រាក់ និងប្រវត្តិប្រតិបត្តិការ ព្រមទាំងរក្សាទុកលុយជាចំនួនគត់សេន (integer cents)។ ផ្ដល់ជូនកូដដើម (source code) ឥតគិតថ្លៃ។
ក្នុងគម្រោងនេះ អ្នកនឹងបង្កើត financial REST API ពេញលេញមួយជាមួយ Python, Flask និង SQLite។ នៅពេល client ផ្ញើ request មកកាន់ Flask វានឹងទៅអាប់ដេតទិន្នន័យក្នុង SQLite រួចឆ្លើយតបមកវិញជា JSON។ ខ្ញុំប្រើ Postman ដើម្បីតេស្តវា ប៉ុន្តែកម្មវិធីវេប កម្មវិធីទូរសព្ទ ឬ command curl ណាក៏អាចហៅទៅប្រើបានដែរ។
កូដពេញលេញមានចែកជូនឥតគិតថ្លៃនៅលើ GitHub៖ https://github.com/rainyreaksmey/python-banking-api
▶ WATCH ON YOUTUBEWatch the video
▶ WATCH ON YOUTUBEវីដេអូពេញ៖
គម្រោងសាកល្បងនេះប្រើគណនីតែមួយ និងមិនទាន់មានប្រព័ន្ធ login នោះទេ។ វាធ្វើឡើងសម្រាប់តែការរៀនសូត្រប៉ុណ្ណោះ ព្រោះប្រព័ន្ធហិរញ្ញវត្ថុជាក់ស្តែងត្រូវការសុវត្ថិភាពតឹងរ៉ឹងបំផុត។
API នេះមានមុខងារអ្វីខ្លះ
| Method | Endpoint | មុខងារ |
|---|---|---|
| GET | / |
បញ្ជាក់ថា API កំពុងដំណើរការ និងបង្ហាញបញ្ជី endpoint ទាំងអស់ |
| GET | /api/account |
បង្ហាញម្ចាស់គណនី ប្រភេទរូបិយប័ណ្ណ និងសមតុល្យ |
| POST | /api/deposit |
ដាក់លុយចូល និងកត់ត្រាប្រតិបត្តិការ |
| POST | /api/withdraw |
ដកលុយចេញ ប្រសិនបើសមតុល្យគណនីគ្រប់គ្រាន់ |
| GET | /api/transactions |
បង្ហាញប្រវត្តិប្រតិបត្តិការ ដោយរៀបពីថ្មីបំផុតមកមុន |
ឈ្មោះ route ជាក់លាក់មាននៅក្នុង repo អ្នកអាចឆែកមើលពួកវាបានតាមរយៈ flask routes។
រៀបចំ environment
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install flaskការប្រើ virtual environment ជួយញែក package របស់គម្រោងនេះឱ្យនៅដាច់ដោយឡែកពីប្រព័ន្ធម៉ាស៊ីនរបស់អ្នក។ ជាមួយគ្នានេះ pip ក៏ដំឡើង dependencies ផ្ទាល់របស់ Flask ផងដែរ រួមមាន Werkzeug, Jinja, Click និង ItsDangerous។ ចំណែកឯហ្វាល់ requirements វិញបានកំណត់ជាប់ទៅលើ Flask 3.1.3 ដើម្បីឱ្យអ្នកគ្រប់គ្នាដំឡើងបាន version ដូចៗគ្នា។
មូលដ្ឋានទិន្នន័យ (Database)
កូដទាំងអស់ស្ថិតនៅក្នុងហ្វាល់តែមួយគឺ app.py ដោយមាន database SQLite នៅក្បែរនោះ។
get_db()បើកការភ្ជាប់ទៅកាន់ SQLite មួយសម្រាប់ request នីមួយៗ ហើយរក្សាទុកវានៅលើ objectgរបស់ Flask ដើម្បីឱ្យ request ដដែលនោះអាចយកវាទៅប្រើឡើងវិញបាន។- row factory ជួយឱ្យអ្នកអាចអានទិន្នន័យតាមឈ្មោះ column បានយ៉ាងងាយ។
- បើកដំណើរការការត្រួតពិនិត្យ foreign-key។
- function teardown នឹងបិទការភ្ជាប់ database វិញ រាល់ពេល request នីមួយៗដំណើរការចប់។
ពេលដំណើរការលើកដំបូង វាបង្កើតតារាងពីរតាមរយៈ executescript៖
| តារាង | Columns |
|---|---|
accounts |
account ID (primary key), ឈ្មោះម្ចាស់, រូបិយប័ណ្ណ, សមតុល្យគិតជាសេន ព្រមទាំងមានលក្ខខណ្ឌកំណត់មិនឱ្យមានតម្លៃអវិជ្ជមាន |
transactions |
auto ID, account ID (foreign key), ប្រភេទ, ចំនួនទឹកប្រាក់, សមតុល្យក្រោយប្រតិបត្តិការ, ពេលវេលាបង្កើត |
ពាក្យបញ្ជា INSERT OR IGNORE នឹងបង្កើតគណនីសាកល្បង ACC-1001 តែម្តងគត់ ទោះបីជា server ត្រូវ restart ប៉ុន្មានដងក៏ដោយ។ គណនីនេះចាប់ផ្តើមដំបូងជាមួយទឹកប្រាក់ 100,000 សេន ដែលស្មើនឹង $1,000។
គ្រប់គ្រងទិន្នន័យលុយកាក់ឱ្យមានសុវត្ថិភាព
នេះជាចំណុចសំខាន់បំផុតនៅក្នុងគម្រោងទាំងមូល។
- កុំរក្សាទុកទិន្នន័យលុយជា float ឱ្យសោះ។ សមតុល្យលុយត្រូវតែជា ចំនួនគត់គិតជាសេន។
- ចំនួនទឹកប្រាក់ដែលផ្ញើចូលមកត្រូវបានអានតាមរយៈ
Decimalហើយកាត់កន្ទុយត្រឹមពីរខ្ទង់ជាមួយROUND_HALF_UPដែលជាវិធីបង្គត់លេខទូទៅរបស់ធនាគារ។ - តម្លៃសូន្យ អវិជ្ជមាន អនន្ត (infinite) និងតម្លៃមិនត្រឹមត្រូវផ្សេងៗ សុទ្ធតែមិនត្រូវបានទទួលយកឡើយ។
- កូដបានចាប់ error ដូចជា
InvalidOperation,TypeErrorនិងValueErrorទុកជាមុន ដូច្នេះពេលមានទិន្នន័យមិនត្រឹមត្រូវ វានឹងបង្ហាញសារ error ច្បាស់លាស់ មិនធ្វើឱ្យគាំង server នោះទេ។
ចំណែក helper មួយទៀតមានតួនាទីបំប្លែងចំនួនសេនមកជាទម្រង់អក្សរដែលមានក្បៀសពីរខ្ទង់វិញ សម្រាប់បង្ហាញនៅក្នុង JSON response។
ដំណើរការ routes នីមួយៗ
Account. ទាញយកទិន្នន័យគណនីសាកល្បងដោយប្រើ parameterized query។ សញ្ញាសួរ ? ជួយញែកតម្លៃទិន្នន័យឱ្យដាច់ពីកូដ SQL ជៀសវាងការសរសេរ query ដោយត string ផ្ទាល់ ដែលងាយរងហានិភ័យ។
Deposit. អានទិន្នន័យពី JSON body រួចបំប្លែងទឹកប្រាក់ទៅជាសេន (បើទិន្នន័យមិនត្រឹមត្រូវ វានឹង return 400) បន្ទាប់មកទាញយកសមតុល្យបច្ចុប្បន្ន បូកបន្ថែមទឹកប្រាក់ រក្សាទុកដោយប្រើ UPDATE កត់ត្រាប្រតិបត្តិការចូល database និង return 201 មកវិញ។
Withdrawal. មានទម្រង់ប្រហាក់ប្រហែលគ្នាដែរ ប៉ុន្តែវាផ្ទៀងផ្ទាត់ចំនួនទឹកប្រាក់ដែលត្រូវដកជាមួយសមតុល្យដែលមានជាមុនសិន។ ប្រសិនបើចំនួនដកធំជាងសមតុល្យ API នឹងបង្ហាញ error ថាលុយមិនគ្រប់ ដូច្នេះសមតុល្យគណនីមិនអាចធ្លាក់ដល់កម្រិតអវិជ្ជមានបានឡើយ។
Transactions. ទាញយកទិន្នន័យប្រតិបត្តិការរបស់ ACC-1001 ដោយប្រើ ORDER BY id DESC រួចបញ្ជូនត្រឡប់មកវិញនូវស្ថានភាពជោគជ័យ ចំនួនប្រតិបត្តិការសរុប និងបញ្ជីប្រតិបត្តិការលម្អិត។
Route គ្រប់គ្រងលុយទាំងពីរនេះប្រើប្រាស់ helper save_transaction មួយរួមគ្នា។ វាធ្វើការបញ្ចូលទិន្នន័យថ្មី commit ទៅ database រួចទាញយកជួរទិន្នន័យដែលទើបតែបញ្ចូលនោះមកវិញដោយប្រើ cursor.lastrowid។
ដំណើរការ និងតេស្តសាកល្បង
flask routes
python3 app.pyពាក្យបញ្ជា flask routes នឹងបង្ហាញរាល់ endpoint ទាំងអស់ដែលបានចុះឈ្មោះ រួមជាមួយ method របស់ពួកវា។ Server នឹងដំណើរការនៅលើ http://127.0.0.1:5000។ ប្រសិនបើបាត់ route ណាមួយ សូម save ហ្វាល់ app.py ហើយ restart ឡើងវិញ។
នៅក្នុង Postman៖
- ផ្ញើ GET ទៅ root URL៖ នឹងទទួលបានសារបញ្ជាក់ និងបញ្ជី endpoint ទាំងអស់។
- ផ្ញើ GET ទៅ account៖ បង្ហាញឈ្មោះម្ចាស់ រូបិយប័ណ្ណ និងសមតុល្យ។
- ផ្ញើ POST ជាមួយចំនួនទឹកប្រាក់ជា JSON ដើម្បីដាក់លុយ៖ ទទួលបានសមតុល្យថ្មី និងទិន្នន័យប្រតិបត្តិការ។
- ផ្ញើ POST ជាមួយចំនួនទឹកប្រាក់ដើម្បីដកលុយ៖ សមតុល្យនឹងត្រូវកាត់បន្ថយ។
- ផ្ញើ GET ទៅ transactions៖ បង្ហាញប្រវត្តិប្រតិបត្តិការ ដោយរៀបពីថ្មីបំផុតមកមុន។
អ្នកក៏គួរតែសាកល្បងផ្ញើតម្លៃមិនត្រឹមត្រូវ ឬចំនួនលុយដកដែលលើសពីសមតុល្យផងដែរ ដើម្បីមើលថាតើប្រព័ន្ធផ្ទៀងផ្ទាត់ទិន្នន័យ (validation) បង្ហាញ error ត្រឹមត្រូវដែរឬទេ។
មុនពេលដាក់ឱ្យប្រើជាក់ស្តែង (Production)
អ្នកត្រូវបន្ថែមការផ្ទៀងផ្ទាត់អត្តសញ្ញាណ (authentication) ការកំណត់សិទ្ធិ (authorization) ការកំណត់សុវត្ថិភាព ការសរសេរ test ព្រមទាំងការកត់ត្រា log និងតាមដានដំណើរការ (monitoring)។ មេរៀនបន្ទាប់នឹងលើកយកចំណុចដំបូងគេមកបង្ហាញ៖ ការផ្ទៀងផ្ទាត់អត្តសញ្ញាណជាមួយ Flask JWT។
តំណភ្ជាប់
- វីដេអូពេញ៖ https://youtu.be/y01R1Aq6UKw
- កូដដើម (Source code)៖ https://github.com/rainyreaksmey/python-banking-api
- គំនិតដូចគ្នានេះលើ FastAPI៖ ការផ្ទៀងផ្ទាត់អត្តសញ្ញាណជាមួយ FastAPI JWT
សាកល្បងកែប្រែមុខងារណាមួយដោយខ្លួនឯង ព្រោះវាជាវិធីលឿនបំផុតដើម្បីដឹងច្បាស់ថាអ្នកពិតជាយល់ពីដំណើរការទាំងមូល។


