In the few jobs I had, I was responsible for creating a new system and integrating it with some other systems. \u00a0 The variety of the systems is pretty much irrelevant – anything from back office systems and CRMs to trading platforms and CMSs. \u00a0The common factor between them is the integration is often done through some form of the API.<\/p>\n
The most important lesson I’ve learned while working with third-party APIs is this:<\/p>\n
Never ever use a third-party API directly from your application. \u00a0Instead, create an abstraction layer between your application and third-party API.<\/p><\/blockquote>\n
This might seem like a bit of extra work, but, trust me, it’s not. \u00a0It will save you plenty of time and frustration. \u00a0Here are my reasons:<\/p>\n
\n
- Your own abstraction layer will help smooth out API’s edges. \u00a0If you are using third-party API, chances are, it feels weird at times. \u00a0It doesn’t matter what sets you off – function names, or required obvious parameters, or maybe the logic or order of calls that you have to make. \u00a0Instead of getting annoyed every time, you can abstract all that weirdness into a separate layer, which will probably not change all too often. \u00a0And your application coding will be more fun.<\/li>\n
- Easier maintenance. \u00a0Even the best APIs change. \u00a0And when it happens, you don’t really want to go through all of your application and change all calls to the old version of the API. \u00a0Especially, if the updated version is not fully backward compatible. \u00a0Instead, you’d just rather update your API abstraction layer and be done with it. \u00a0And if you do, like you should, have unit tests covering your API abstraction layer, it will be trivial for you to see if you broke anything or not.<\/li>\n
- Easier reuse and more control. \u00a0One of the biggest problems with third-party APIs is that you don’t control them. \u00a0Third-party introduces features, bugfixes, upgrades, and maintenance down-times whenever THEY want. \u00a0You rarely have much say in it. \u00a0When you have a layer in between the third-party API and your application, you have more control as to how all those things affect your application.<\/li>\n
- Easier migration to another third-party API. \u00a0And you know that these things do happen. \u00a0You’ve been using one provider of the service, and now there is a better one. \u00a0If you were using first provider’s API directly from your application, you are pretty much in trouble now. \u00a0Going through the whole application replacing calls to the new API, with different set of parameters, data types, and return values, is a huge undertaking. \u00a0If only you had an abstraction layer, all you’d have to do now would be to change that instead. Sure, you might need to extend it a bit, or introduce changes to the currently used functionality. \u00a0But, from my experience, such changes would be much smaller and simpler (since you are working with your code on both ends).<\/li>\n<\/ol>\n
<\/p>\n\n","protected":false},"excerpt":{"rendered":"\n
In the few jobs I had, I was responsible for creating a new system and integrating it with some other systems. \u00a0 The variety of the systems is pretty much irrelevant – anything from back office systems and CRMs to trading platforms and CMSs. \u00a0The common factor between them is the integration is often done … Continue reading On using third-party APIs<\/span><\/a><\/p>\n\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false,"_links_to":"","_links_to_target":""},"categories":[1,18,62],"tags":[2404,1264],"keyring_services":[],"class_list":["post-16594","post","type-post","status-publish","format-standard","hentry","category-general","category-programming","category-technology","tag-api","tag-integration"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t