Վերջին խմբագրում՝
Click to expand / collapse
Երբ API-ն ակտիվորեն զարգանում է, կարևոր է պահպանել տարբերակների միջև համատեղելիությունը և խուսափել իրավիճակներից, երբ մեկ փոփոխություն կոտրում է տասնյակ հաճախորդների ինտեգրումներ։ Մենք իրականացնում ենք կոդավորման ամբողջական տարբերակը, որը թույլ է տալիս վերահսկել փոփոխությունները և սահուն նորարարել API-ը առանց օգտագործողների ռիսկի։
Սա կարևոր է միկրովայրկյան ճարտարապետության, B2B ինտեգրման և բաց API արտադրանքների մեջ, որտեղ տարբեր հաճախորդները օգտագործում են ինտերֆեյսների տարբեր տարբերակներ։
Ի՞ նչ ենք մենք տարբերակում
| Օբյեկտ | Նկարագրություն |
|---|---|
| OpENAPI ճշգր | Մենք հավաքում ենք փաստաթղթերի և պայմանագրի յուրաքանչյուր տարբերակ |
| Endpoint'ы | Մենք ավելացնում ենք URL տարբերակները («/v1/», «/v2/»), պահպանում ենք backward compatibility |
| Պայմանագրեր (Pact, Dredd) | Հաճախորդի և հաճախորդի միջև փոխազդեցության պայմանների ամրագրում |
| Տվյալների մոդելներ | Փոփոխությունների վերահսկումը հարցման կառուցվածքում և պատասխանները |
Ինչպես ենք մենք իրականացնում
API-ի մի քանի տարբերակների աջակցություն զուգահեռ:- Ակնհայտ նշումը URL-ում, վերնագրերում կամ գրանցամատյաններում
- Յուրաքանչյուր տարբերակի ավտոտեստավորումը (Pact, Postman, Jest, Dredd)
- Հատուկ տարբերակումը Git կամ CI/CD միջոցով
- System և changelog հաճախորդների համար յուրաքանչյուր փոփոխությամբ
Առավելություններ
Ինտեգրման երաշխավորված իրականացում:- Հնարավորություն թողարկել նոր ֆիչեր առանց ռիսկի «կոտրել» հաճախորդներին
- Տարբերակների միջև կոդավորման պարզեցում
- Հստակ պատմություն փոփոխության և վերահսկման մասին
- Թափանցելիությունը արտաքին և ներքին զարգացման թիմերի համար
Որտեղ հատկապես կարևոր է
Միկրովայրիկ ճարտարապետությունը բազմաթիվ կախվածություններով:- Պլատֆորմներ հանրային կամ B2B API
- Ֆինանսական և բյուջետային համակարգերը երկարաժամկետ պայմանագրերով
- Բջջային ծրագրեր, որոնք կախված են կայուն API ինտերֆեյից
Մրցույթի տարբերությունը API-ի կանխատեսելիության և վստահության հիմքն է։ Մենք ներդնում ենք գործընթացներ, որոնք թույլ են տալիս փոխել և զարգացնել API առանց ցավի 'պահպանելով բոլոր կողմերի համար համատեղելիությունն ու թափանցիկությունը։