Қазіргі заманғы API-интеграцияларда деректерді жіберу немесе алу ғана емес, барлық оқиғалар бір рет, дұрыс және сенімді өңделетініне кепілдік беру маңызды. Біз аралық жағдайларды сақтай отырып, сыртқы сервистер мен кезектермен жұмыс істеудегі жоғалулар мен дубльдерді болдырмау үшін (retries) қайта жеткізу тетіктерін және хабарламаларды дедупликациялауды жүзеге асырамыз.
Бұл транзакциялармен, төлем шлюздерімен, webhook-оқиғалармен және бір реттік және аяқталуы қиын фондық міндеттермен жұмыс істегенде ерекше маңызды.
Не жүзеге асырылды
| Механизм | Мақсаты және артықшылықтары |
|---|---|
| Күйді сақтау | Істен шыққан жерден жалғастыру немесе өңдеу барысын қадағалау мүмкіндігі |
| Автоматты retries | Экспоненциалдық кідіріспен қате болған жағдайда қайталап әрекет ету |
| Deduplication | Бірдей сұрауларды немесе оқиғаларды екі рет өңдеуден қорғау |
| Оқиға идентификаторлары | Қолдау 'event _ id', 'message _ id', hash-трекинг |
| Кейінге қалдырылған тапсырмалар | Егер сыртқы қызмет уақытша қол жетімді болмаса, кейінірек қайталап көру |
Бұл қалай жұмыс істейді
1. Кіріс сұрауы немесе оқиға бірегей сәйкестендіргішті алады
2. Жазба өңдеу журналына қосылады (ДҚ, Redis немесе Kafka)
3. Қате болған жағдайда міндет retry кезегіне қойылады (лимитпен және бақылаумен)
4. Сол оқиғаны қайта алған кезде - жүйе оның ID-ін тексереді және телнұсқасын қабылдамайды
5. Бүкіл оқиғалар тарихы мен өңдеу мәртебесі аудит үшін қол жетімді
API және платформа үшін артықшылықтары
Желі ақаулары, қайталанған webhook 'ax немесе клиенттің қателері кезінде қайталауларды болдырмау
Уақытша ақаулықтар кезінде де сенімді жеткізу
Сыртқы API және базаларға жүктемені барынша азайту
Дәл логирлеу, аудит және қалпына келтіру мүмкіндігі
Әртүрлі сценарийлермен (төлемдер, бонустар, оқиғалар) масштабталуы және икемділігі
Ерекше маңызды жерде
Қаржылық транзакциялар, биллинг, депозиттер
Ойын оқиғалары: ставкалар, ұтыстар, есептеулер
Webhook және баяу API-мен интеграциялау
Жоғары жүктемелі және фондық міндеттері бар сәулеттер
Жай-күй, retries және дедупликация - бұл API-интеграцияны тұрақты етеді. Біз логиканы істен шығулар мен тұрақсыз қосылыстар жағдайында сіздің деректеріңіз қауіпсіз болатындай етіп жобалаймыз, ал процестер дубликаттарсыз аяқталады.