کاتالوگ API یک کتابخانه قابل جستوجو و بسیار سازمانیافته از APIهای موجود است که پیدا کردن و استفاده از APIهای مورد نظر را برای مصرفکنندگان آسانتر میکند. کاتالوگهای API خصوصی شامل همه APIهای داخلی درون یک سازمان هستند و با کمک به تیمها برای شناسایی کدهای تکراری و پیروی از استانداردهای سراسری سازمان، فرآیند مدیریت API را روانتر میکنند. در مقابل، کاتالوگهای API عمومی تولیدکنندگان API را به مصرفکنندگان شخص ثالث متصل میکنند که این کار باعث شکلگیری جامعههای توسعهدهنده، کوتاه شدن حلقههای بازخورد و تولید درآمد میشود. APIهایی که در کاتالوگهای خصوصی و عمومی فهرست میشوند ممکن است مصنوعات مرتبطی نیز داشته باشند، مانند مستندات، درخواستهای نمونه و تستها، تا به مصرفکنندگان کمک کنند زمان رسیدن به اولین فراخوانی را کاهش دهند.
چرا کاتالوگهای API در دنیای API-first مهم هستند؟
API-first یک مدل توسعه است که در آن برنامهها با ترکیب سرویسهای داخلی یا خارجی که از طریق API ارائه میشوند، مفهومپردازی و ساخته میشوند. این رویکرد در سالهای اخیر بهطور فزایندهای محبوب شده است و از چندین مورد استفاده متفاوت API پشتیبانی میکند. برای مثال، این رویکرد برای معماریهای مبتنی بر میکروسرویس ضروری است؛ جایی که برنامهها بهصورت مجموعهای از سرویسها ساخته میشوند که از طریق APIهای داخلی با یکدیگر ارتباط برقرار میکنند. علاوه بر این، تأکید آن بر کیفیت API یک چارچوب محکم برای تیمهایی فراهم میکند که APIها را بهعنوان محصولات قابل فروش به مصرفکنندگان شخص ثالث عرضه میکنند.
APIهای خصوصی و عمومی نقشهای متفاوتی در استراتژی کلی کسبوکار یک سازمان دارند، اما تیمهایی که آنها را مدیریت میکنند میتوانند به یک اندازه از بهبود کشفپذیری، همکاری و حاکمیتی که کاتالوگهای API تسهیل میکنند بهرهمند شوند.
تفاوت کاتالوگهای API خصوصی و عمومی چیست؟
هم کاتالوگهای API خصوصی و هم عمومی پیدا کردن APIهایی را که نیازهای مصرفکننده را برآورده میکنند آسانتر میسازند، اما هر نوع کاتالوگ چندین مزیت متمایز دارد.
مزایای کاتالوگهای API خصوصی
یک کاتالوگ API خصوصی یک هاب یکپارچه برای تمام APIهای داخلی درون یک سازمان است. این کاتالوگها دید کامل نسبت به چشمانداز کلی APIهای سازمان فراهم میکنند که هم به توسعهدهندگان و هم به رهبران کسبوکار سود میرساند. برای مثال، کاتالوگهای API خصوصی به توسعهدهندگان کمک میکنند از نوشتن کدهای تکراری برای پیادهسازی جریانهای کاری رایج، مانند احراز هویت کاربر، اجتناب کنند. در عوض، میتوانند APIهایی را جستوجو کنند، پیدا کنند و مصرف کنند که توسط تیمهای دیگر برای همان هدف توسعه داده شده است. کاتالوگهای API همچنین بینشی بهروز درباره روندهای استفاده از APIهای داخلی در سراسر سازمان ارائه میدهند که میتواند تصمیمهای مهم درباره توزیع ظرفیت (bandwidth) را آگاهانهتر کند. در نهایت، ماهیت متمرکز کاتالوگهای API باعث میشود برای رهبران آسانتر باشد که یک استراتژی مؤثر حاکمیت API را در تمام تیمهای سازمان اعمال کنند.
مزایای کاتالوگهای API عمومی
کاتالوگهای API عمومی APIها را برای مصرفکنندگان شخص ثالث کشفپذیرتر میکنند. این میزان دیدهشدن بهویژه برای شرکتهایی اهمیت دارد که APIهای خود را بهعنوان محصولات قابل فروش بازاریابی میکنند، زیرا ترافیک API و در نتیجه درآمد را افزایش میدهد. کاتالوگهای API عمومی همچنین سیلوها بین مصرفکنندگان و تولیدکنندگان API را از بین میبرند، که حلقههای بازخورد را کوتاه میکند و به تولیدکنندگان کمک میکند پشتیبانی کافی ارائه دهند.
پراکندگی API چیست و کاتالوگهای API خصوصی چگونه کمک میکنند؟
همانطور که بالاتر گفته شد، بسیاری از تیمها برای نوسازی پشته فناوری خود تصمیم گرفتهاند برنامههای یکپارچه (monolithic) را به میکروسرویسها تبدیل کنند که از طریق APIها به یکدیگر متصل هستند. میکروسرویسها میتوانند مستقل از یکدیگر مستقر شوند، منابعگذاری شوند و مقیاس بگیرند، که به سازمانها امکان میدهد هزینهها را کنترل کنند، سریع تکرار کنند و با موجهای افزایش ترافیک همگام بمانند.
با این که میکروسرویسها مزایای زیادی دارند، چالشهایی هم ایجاد میکنند، بهویژه وقتی یک سازمان رشد میکند. برای مثال، ممکن است برای معماران نرمافزار دشوار باشد تصمیم بگیرند منطق یک مونولیت قدیمی را چگونه تفکیک کنند. این میتواند به ایجاد میکروسرویسهای بیش از حد منجر شود که اغلب قابل استفاده مجدد نیستند. علاوه بر این، برخی میکروسرویسها و APIهایشان ممکن است با تغییر نیازهای کسبوکار بهصورت بیسر و صدا رها شوند. چشمانداز API حاصل، مبهم، سخت برای مدیریت و مستعد رخنههای امنیتی خواهد بود.
کاتالوگهای API خصوصی پادزهری برای این پدیده هستند که با نام «پراکندگی API» شناخته میشود، زیرا به رهبران کسبوکار و تیمها اجازه میدهند از تمام APIهای موجود در کدبیس سازمان خود فهرستبرداری کنند. این سطح از دید باعث میشود شناسایی APIهای تکراری، قدیمی و ناسازگار آسانتر شود، و سپس در صورت نیاز منسوخسازی یا وصلهکردن آنها انجام شود. وقتی یک کاتالوگ API برقرار باشد، تیمها میتوانند تلاشهای توسعه API خود را هدفمندتر انجام دهند، که تضمین میکند فقط APIهای ضروری، امن و باکیفیت در چرخه باقی بمانند.
Postman چگونه از کاتالوگهای API پشتیبانی میکند؟
پلتفرم Postman API که توسط G2 بهطور مداوم بهعنوان بهترین ابزار مدیریت API رتبهبندی شده است، دو راه برای بهرهبرداری توسعهدهندگان از مزایای یک کاتالوگ API ارائه میدهد. اول، سازمانها میتوانند APIهای خود را در شبکه API عمومی (Public API Network) فهرست کنند که بزرگترین هاب مصنوعات API عمومی در جهان است. شبکه API عمومی به اعضای جامعه Postman امکان میدهد:
اکوسیستم توسعهدهندگان خود را رشد دهند:
تیمهایی که APIهای خود را در شبکه API عمومی در دسترس قرار میدهند میتوانند با بیش از ۴۰ میلیون توسعهدهنده در سراسر جهان ارتباط برقرار کنند.
پشتیبانی مستقیم به مصرفکنندگان ارائه دهند:
تیمها میتوانند درخواستهای نمونه، پیکربندیهای پیشفرض و مستندات را در شبکه API عمومی منتشر کنند که میتواند پذیرش API را افزایش دهد و حجم تیکتها را کاهش دهد.
جستوجو کنند و الهام بگیرند:
توسعهدهندگان میتوانند داراییها را در شبکه API عمومی بر اساس دستهبندی و تیم مرور کنند و همچنین کالکشنها و ورکاسپیسهای برجستهای را ببینند که توسط تیم Postman انتخاب شدهاند.
علاوه بر این، تیمها میتوانند از شبکه API خصوصی (Private API Network) برای ساخت یک کاتالوگ از مصنوعات API داخلی استفاده کنند. این کار به آنها امکان میدهد:
APIها، ورکاسپیسها و کالکشنهای داخلی را کشف کنند:
شبکه API خصوصی دید کامل نسبت به هر API، ورکاسپیس و کالکشن درون سازمان فراهم میکند که به تیمها کمک میکند با هم همکاری کنند و از یکدیگر یاد بگیرند.
چشمانداز APIهای داخلی را حکمرانی کنند:
رهبران میتوانند به گزارشها برای درک عمیقتر از فعالیت API در شبکه API خصوصی خود دسترسی داشته باشند. برای مثال، گزارشها میتوانند برای ردیابی حجم درخواست، عملکرد، شکستهای تست و پایبندی به SLA برای هر API خصوصی استفاده شوند.
از یک جریان کاری تأیید اختیاری استفاده کنند:
مدیران شبکه میتوانند با یک جریان کاری تأیید اختیاری کنترل کیفیت را اعمال کنند، که تضمین میکند فقط مصنوعات بررسیشده و تأییدشده در شبکه خصوصی منتشر شوند.
