API мен бэкенд әзірлеу
NDDev сайттарға, мобильді қосымшаларға және ішкі жүйелерге арналған бэкенд пен API әзірлейді: деректер модельдерін, бизнес-логиканы, авторизацияны, вебхуктар мен фондық тапсырмаларды жасайды. Негізгі стегіміз: Python, FastAPI, SQLAlchemy және PostgreSQL, ал кэш пен кезектер үшін Redis қолданамыз. Компания 2019 жылдан бері жұмыс істейді.
Кімге лайық?
Фронтенді немесе мобильді қосымшасы бар және серверді қажет ететін командаларға, серіктестеріне өз деректерін API арқылы ашатын компанияларға, сондай-ақ ескі бэкендінің шеңберінен өсіп шыққан өнімдерге арналған.
- Нұсқалары бар REST API
- Авторизация және құқықтар
- Вебхуктар және фондық тапсырмалар
- Тестілер және құжаттама
Біз тапсыратын бэкенд қалай құрылған
API жобалауды деректерден бастаймыз. Алдымен PostgreSQL-дегі модель мен эндпоинттер контрактысын дайындаймыз, содан кейін код жазамыз. Нұсқаны мекенжайда, мысалы /api/v1/ түрінде көрсетеміз, тізімдерді курсорлық пагинациямен береміз, ал қателерді бірыңғай форматта қайтарамыз. Клиентке икемді іріктемелер немесе нақты уақыттағы оқиғалар қажет болғанда, GraphQL мен WebSocket қосамыз.
- деректер моделі мен PostgreSQL миграциялары
- нұсқалары, пагинациясы және бірыңғай қате форматы бар REST API
- JWT, OAuth 2.0 аутентификациясы немесе хаттағы сілтеме арқылы кіру
- сервер тарапындағы RBAC немесе ABAC құқықтары
- фондық тапсырмалар, кезектер және жоспарлаушы
- қолтаңбасы тексерілетін вебхуктар
- unit және интеграциялық тестілер
- Docker-образ және орналастыру бойынша README
Ұзақ операциялар фонға жіберіледі: хаттар, 1С-пен алмасу, файлдарды өңдеу. Тапсырмалар мен шығыс оқиғаларды PostgreSQL-де деректермен қатар сақтаймыз, сондықтан оқиға дәл жазба сақталған сәтте пайда болады. Алматы ОКЖ бэкенді осылай құрылған: FastAPI-сервистер, синхрондаудың, кітаптардың, пошта мен хабарламалардың воркерлері және кесте бойынша орындалатын тапсырмаларға арналған бір жоспарлаушы бар.
Сыртқы шақыруларды қорғаймыз. Вебхук қолтаңбасын тексереміз, қайталауларды идемпотентті түрде өңдейміз, ал серіктес тарапында іркіліс болса, сұранысты үзілісті ұзарта отырып қайталаймыз және circuit breaker арқылы шақыруларды уақытша өшіреміз. Әрбір шақыру логқа жазылады, ал құпиялар орта айнымалыларында сақталады.
API бойынша жұмыстың үш кезеңі
Контракт
Нысандарды, эндпоинттерді, рөлдер мен қателерді сипаттаймыз. Фронтенд пен мобильді команда сервермен қатар, контракт бойынша жұмысты бірден бастайды.
Іске асыру және тестілер
Сервисті, миграциялар мен тестілерді жазамыз, оны тест серверінде орналастырып, сіздің әзірлеушілеріңізге кіру рұқсатын береміз.
Шығару және тапсыру
API-ді жұмыс күйін тексеру тетіктерімен және логтармен бірге жұмыс серверіне орнатамыз, репозиторийді, құжаттаманы және кіру рұқсаттарын тапсырамыз.
Бэкенд туралы не сұрайды
API әзірлеу қанша тұрады?
API үшін «бастап» бағасы құн блогында көрсетілген. Қорытынды сомаға нысандар мен эндпоинттер саны, интеграциялар, сондай-ақ жүктеме мен қауіпсіздік талаптары әсер етеді. API контрактысы түсінікті болған кезде, соңғы баға мен мерзімді техникалық тапсырмаға жазамыз.
Неліктен Python және FastAPI?
FastAPI бізге Pydantic негізіндегі типтелген модельдерді, SQLAlchemy 2 арқылы дерекқормен асинхронды жұмысты және тікелей кодтан алынатын эндпоинттер сипаттамасын береді. Ал жылдамдыққа ерекше талап қойылатын сервистерді Go-да немесе Node.js-те жазамыз.
Қолданыстағы бэкендімізді әрі қарай әзірлей аласыздар ма?
Иә. Алдымен код пен дерекқор схемасын оқып шығамыз, тестілерді іске қосамыз және ненің жұмыс істеп тұрғанын әрі қай жерде тәуекелдер бар екенін сипаттаймыз. Жаңа эндпоинттерді ескілерімен қатар қосып, клиенттерді оларға біртіндеп көшіреміз.
API-ді қалай тестілейсіздер?
Unit-тестілер бизнес-логиканы тексереді, ал интеграциялық тестілер нақты PostgreSQL базасында өтеді. Сыртқы тұтынушылар үшін жауаптардың формасын Abonmarket жобасындағыдай контрактілік тестілермен бекітеміз, және өзгеріс шығарылымға дейін көрінеді.
API жүктемеге төтеп бере ме?
Іске қосар алдында жүктемелік тестілеу жүргіземіз, жиі қайталанатын сұраныстарды Redis-те кэштейміз, ал ауыр операцияларды фонға шығарамыз. Сервис Nginx артындағы контейнерлерде жұмыс істейді, және өсуіне қарай оны масштабтауға болады.
Жұмыс тапсырылғанда не аламыз?
Репозиторийді, API құжаттамасын, орналастыру бойынша README файлын, сервер мен дерекқорға кіру рұқсаттарын және тапсыру сәтіндегі резервтік көшірмені аласыздар. Кодқа қатысты құқықтарды келісім бойынша береміз.
210 000 ₽ бастап
- Тегін кепілдік
- 30 күн
Бағалар бастапқы деңгейден көрсетілген және тек ақпарат үшін берілген; олар жария оферта болып саналмайды. Соңғы құн техникалық тапсырмада бекітіледі.
Web development
Тақырып бойынша
API-іңіз кімге және қандай деректер беруі керек екенін сипаттаңыз
Деректер схемасын, экран макеттерін немесе интеграция сипаттамасын жіберіңіз. Біз API контрактысын ұсынамыз және бағасын айтамыз.
24 сағат ішінде жауап береміз