APIはアプリケーションプログラミングインターフェースの略です。 API について説明する場合、特定の機能を持つソフトウェアはアプリケーションと呼ばれます。 API インターフェイスを、要求と応答を指定する XNUMX つのプログラム間のサービス契約と比較できます。 API を初めて使用する場合は、こちらをご覧になることをお勧めします API の初心者向けガイド および REST API の概要 このブログを読む前に。
REST API HTTP/HTTPS プロトコルを介して CRM データにアクセスできます。 任意の CRM レコード情報に対して、作成、更新、取得、または削除操作などのアクションを実行できます。 また、拡張機能固有およびユーザー固有の構成データを保存したり、保存された拡張機能固有のデータを使用して外部アプリケーションに接続したりすることもできます。 このすべてのデータには、ユーザー名とアクセス キーによる基本認証を使用してアクセスできます。
REST API の作成
以下は、任意の API を構築するために使用できる XNUMX つの一般的な手順です。
API を計画する: API を設計するためのガイドラインは、OpenAPI などの API 仕様によって提供されます。 事前にさまざまなユースケースを検討し、API が現在の API 開発標準に準拠していることを確認することが望ましいです。
API を構築する: API 設計者は、既存の API をほとんど変更せずに、新しい API のプロトタイプを作成します。 開発者は、テスト後にプロトタイプを内部要件に適合させることができます。
API をテストする: ソフトウェア テストと同様に、エラーや欠陥を防ぐために API テストが必要です。 API テスト用のツールを使用して、オンライン攻撃に対する API の強度をテストします。
API を文書化する: API は一目瞭然ですが、ドキュメントはユーザーにとってより簡単に役立ちます。 サービス指向アーキテクチャでは、さまざまな機能とユースケースを備えた十分に文書化された API がより頻繁に使用されます。 方向性を示し、他のユーザーが API を構築するのを支援するヘルプ ドキュメントを作成します。
API のマーケティング: eBay、Amazon、Flipkart の小売商品と同様に、開発者が API を売買できるオンライン マーケットプレイスがあります。 API をリストすることで、API から収益を得ることができます。
このブログでは、Vtiger の API Designer を使用してカスタム REST API コマンドを作成する方法を説明します。 それでは始めましょう。
API デザイナーとは何ですか?
API Designer は、カスタム Web サービス API を構築するために開発者が使用できるツールまたはアプリケーションです。 カスタム サービス エンドポイントとクエリ パラメータを定義できます。 これらの API を使用して、CRM データとやり取りしたり、外部アプリと統合したり、これらのデータを VTAP Javascript API に公開して、Vtiger UI のカスタム ページまたはウィジェット内で使用したりできます。
Vtiger Application Design Language (VADL)、これは大まかに XML 構文に基づいています。 VADL を使用すると、高度なプログラミング スキルを持たない管理者や開発者でも API を簡単に定義できますが、プログラミングの基本的な知識があれば、効果的な API をすばやく作成できます。
REST API は標準の REST API プロトコルに従い、エンドポイントを次のように定義できます。