2018年はAPIの世界にとって変革の年でした。
OpenAPI仕様（OAS）のようなオープンスタンダードは、AWS API GatewayやSwaggerHubのようなAPIツールスペースのリーダーがOAS 3.0のサポートを拡大したことで、広範囲にわたる成長と採用が見られました。また、2019年3月のSalesforceによるMulesoftの64億ドルの買収や、2018年7月のBroadcomによるCA Technologiesの189億ドルの買収など、ベンダー統合の継続的な傾向も見られました。
ここSmartbearでは、既存のAPIのOAS 3.0定義を探索および生成するためのSwagger Inspectorのローンチ、大規模なAPI標準を強制するためのAPI標準化のリリース、SwaggerHubでのOAS 3.0コード生成サポート、そしてReadyAPIテストプラットフォームにおけるユーザーの進化するワークフローをサポートするためのネイティブJenkinsプラグインの追加など、APIツールの多くの新しい進歩をもたらすことができて大変嬉しく思っています。
2018年には、ソフトウェアチームがAPI開発を促進するための新しいプラットフォームへの投資を増やしていることも見られました。現在、20万を超えるAPIプロバイダーがSwaggerHubを活用して、API設計を標準化し、OpenAPI仕様でAPI開発をスケールしています。私たちはこれらのチームのいくつかのリーダーから話を聞く機会があり、彼らがSwaggerHubを採用することでどのように素晴らしい成長をサポートしたり、APIワークフローを最新化したりできたかのストーリーを共有してくれました。
新年を迎えるにあたり、これらのストーリーの一部を取り上げ、2019年にさらに多くのソフトウェアチームがAPI開発プラットフォームに投資する理由のいくつかを紹介したいと思います。
1. 標準化がスケールの鍵
成長するAPIカタログを持つ組織で働くAPIアーキテクトから何度も聞いたことの1つは、標準化の欠如がチームの時間とリソースにとって最大の負担の1つであるということです。
ほとんどのチームにとって、API全体で標準を設定し強制するプロセスは完全に手動です。多くの場合、そのプロセスには複数のチームまたはチームメンバーが関与し、APIとステークホルダーの数が増えるにつれて、さらに苦痛になります。
これは、2017年にSwaggerHubを採用したViasatチームが直面していた問題です。ViasatのソフトウェアエンジニアであるRoger Prenger氏によると：
「同じ種類のデータを使用する多くのインターフェースがあり、異なるインターフェース間でデータの見え方が変わることに苦労していました。問題は、あるAPIではある名前で呼ばれ、別のAPIでは別の名前で呼ばれ、さらに別のAPIでは3番目の名前で呼ばれることでした。システムを通じてデータを追跡することが混乱していました。」
ViasatはSwaggerHubで、ドメインと呼ばれる再利用可能なコンポーネントでデータモデルを標準化できる機能を発見しました。ドメインを使用すると、追加の強制なしに、API全体で使用できる共通モデルを作成できました。
「SwaggerHubのドメインを使用して、すべてのAPIで共通の基本データ構造を使用する方法を見つけました。」
2. コミュニケーションの障害を取り除く
これまで以上に多くのコミュニケーションチャネルがある現在、コラボレーションは完全に合理化されたプロセスであると考えるでしょう。残念ながら、新しいSwaggerHubユーザーから定期的に聞くのは、Slackメッセージ、電子メール、JIRAコメントなどの分散したコミュニケーションチャネルが、APIのライフサイクル全体で行われる変更の可視性の欠如につながる可能性があるということです。
API開発、特に計画と設計の初期段階では、変更を伝え、質問を提起し、フィードバックを提供するための標準的な形式が、下流での問題を回避するために重要です。これは、チーム間や地理的な範囲で作業する場合にさらに重要になります。
これはBonotelのCIOであるScot Hastings氏から聞いたことです。
「SwaggerHubは、社内チームと外部パートナー間のAPI開発に関するコミュニケーションを大幅に改善します。これは、内部で多くのAPI開発を行わないため、ほとんどの作業がパートナーを通じて行われ、パートナーも互いに連携しているため、重要です。SwaggerHubは、すべての可動部品間のコラボレーションのための集中ホストとして機能し、プロセスを非常に効率的、直感的、シームレスにします。」
現在のAPI開発ワークフローでコラボレーションが障害になっていますか？ BonotelがSwaggerHubでコラボレーションを合理化した方法をご覧ください。
3. デザインファーストへの転換
2018年には、「デザインファースト」のアプローチをAPI開発に採用する組織が増加しました。2018年10月に実施され、2019年1月に正式に公開される3,000を超えるAPIプロバイダーの調査では、組織のほぼ半数が、開発中のAPIの少なくとも一部にデザインファーストのアプローチを採用していることがわかりました。
デザインファーストのアプローチへの移行は、チームがAPI開発の早い段階で連携を強化するのに役立ち、その結果、エラーが減り、イテレーションが速くなり、並行開発が可能になります。これは、Realpageのモバイル開発担当ディレクターであるTravis Koenig氏が、SmartBearユーザーカンファレンスであるSmartBear Connectで「エンタープライズAPI開発プロセスの近代化」について発表した際に議論したことです。
Travis氏は次のように説明しています。
「SwaggerHubは、これまで不可能だった方法でプロジェクトを実行することを可能にし、ライフサイクル全体で多くのチームがより並行して実行し、開発を加速することを可能にします。」
4. APIディスカバリの一元化
内部ディスカバリは、複数のチームとステークホルダーがAPIの開発とメンテナンスに関与するまで見過ごされがちな課題です。ディスカバリに関連する一般的な問題の1つは、チームがAPIの最新バージョンを見つけて作業する方法に関するものです。これは、チームがソースコードだけでなくAPI定義も保存するためにGithubのようなソース管理ホストに依存している場合にしばしば発生します。
そのため、SwaggerHubではOAS定義とAPIドキュメントのホスティングとバージョン管理をサポートする機能を構築しました。SwaggerHubは、チームが既存のAPIを探索するための、また開発チームがAPIの設計者とコンシューマの両方に異なる役割を持つ適切なステークホルダーにアクセスを割り当てるための集中リポジトリとして機能します。SwaggerHubで行われた変更は、Githubリポジトリとも同期され、SwaggerHubがAPIドキュメントの信頼できる情報源となります。
Evosus, Inc.のアーキテクトであるSteve Hawkins氏は、SwaggerHubでAPIディスカバリを改善することがコストと労力の削減にどのように役立つかを説明しています。
「SwaggerHubは、APIの開発とプレゼンテーションの両方に効果的なポータルを提供してくれました。私たちはSwaggerHubをAPIコンシューマ向けの参照ドキュメントとして使用しています。私たちは、APIを実装する開発者がコード生成オプションを使用して、労力とコストを削減していることを学びました。」
5. オープンソースツールの成長を上回る
オープンソースのSwaggerツールの背後にある企業として、私たちはオープンソースの力、特に迅速にスケールアップしようとしており、技術的な障害を取り除きたい組織にとっての力を理解しています。しかし、APIプログラムが成長し、より複雑になるにつれて、ワークフローをサポートするツールの必要性が明らかになります。
これは、SmartBear Connect 2018での彼女のプレゼンテーション「デザインファーストのアプローチで急速なシステム成長をサポートする」の中で、ViasatのシステムエンジニアであるCyndi Recker氏が議論したことです。
「『スケールアップ』フェーズでは、迅速に行動し、すべてをまとめようとします。スケールアップフェーズを過ぎると、ビジネスのやり方に関していくつかのことをロックダウンする必要があります。SwaggerHubに移行することに関しては、それが私たちにとっての利点でした。SwaggerオープンソースはSwaggerHubで得られるものの基礎ですが、私はいつも『なぜSwaggerHubに移行する必要があるのか？』という質問を受けます。そして、あなたのチームが成長し、あなたの製品が成長し、あなたの市場が成長するにつれて、これが問題に取り組む方法であると言えます。」
成長をサポートするツールを持つことは、サイロを打破し、コラボレーションを改善し、スケーラブルなAPIプログラムの構築を妨げる摩擦を減らすのに役立ちます。そして、SwaggerHubはSwagger Editor、Swagger UI、Swagger Codegenのようなツールの機能を1つの集中プラットフォームに統合しているため、SwaggerHubへの移行はチームにとってシームレスなプロセスになります。
2019年を迎える準備はできていますか？
20万人を超えるSwaggerHubユーザーと数百万人のSwaggerオープンソースユーザーが2019年に達成する素晴らしいことに期待しています。私たちは現代のAPIチームのニーズを満たすためにツールを進化させ続け、仕事を成し遂げるための新しい機能を構築し、信頼できるツールと統合して高品質なAPIを提供していきます。
2019年にSwaggerHubをあなたのAPIの旅の一部にしましょう。今すぐデモを予約するにはここをクリックしてください。