RESTful API

一般に RESTful API として知られている表現型状態転送アプリケーションプログラミングインターフェイスは、ソフトウェアアプリケーション間の通信のゴールドスタンダードとして広く認められています。

RESTful APIは、GETコマンドが導入された1991年に制定されたHTML標準をベースにしています。GET コマンドはインターネットトラフィックのほとんどを占めており、ブラウザがサーバーに Web ページまたはアセットを要求したときに実行されます。本質的には「読み込み」コマンドです。ただし、元の標準で指定されていたのは GET コマンドだけではありませんでした。POST、PUT、PATCH、DELETEなどの他のコマンドもこのオリジナルのプロトコルの一部でした。インターネット上のどこかのエンドユーザーがDELETEリクエストを送信できるようにサーバーをセットアップするなんて想像もつきませんが、それは当初の仕様でした。

10 年を過ぎると、Web 2.0、つまり API 主導の Web サイトの出現が見え始めました。これらの最初の JavaScript 主導の Web サイトは 2010 年代になって初めて人気を博しましたが、Web 体験に大きな変化をもたらしました。これらのサイトは、エンドユーザーのブラウザにページをレンダリングし、ウェブサーバーのAPIを呼び出して、ページの特定の部分に関する最新データを取得します。この革新により、ユーザーが更新データを必要とするたびにページ全体を再生成して送信する必要がなくなりました。

今日では、ほとんどすべてのウェブサイトやウェブアプリケーションが、エンドブラウザでJavaScriptによって管理される何らかのAPIを採用しています。ウェブサイトに小さな機能を追加する革新的なアプローチとして始まったものが、今では新しいプロジェクトの最初から検討されていた基本的な建築設計コンセプトへと発展しました。この文脈では、API は HTML そのものよりも重要になっています。

RESTful API は、これまで Web ページの送信、編集、取得に使用されてきた HTTP 標準を活用して、他のタイプのデータ、主に JSON オブジェクトを処理します。JSON オブジェクトは (初期の API で使用されていた) XML ドキュメントのよりコンパクトな形式で、文字列、数値、配列、その他のオブジェクトなど、さまざまなデータ型を格納できます。

RESTful API、HTTP コマンドを使用してください。GET コマンドはデータを読み込み、PUT と PATCH はデータの作成と編集に使用し、POST は特定の機能のためにデータをウェブサーバーに送信し、DELETE はデータを削除します。

Nexoidでは、すべてのオペレーションがRESTful APIに基づいています。たとえば、ログインしてセッショントークンを取得するには POST リクエストを送信し、レコードを取得するには GET リクエストを使用し、作成と更新は PUT コマンドと PATCH コマンドで処理されます。フロントエンドを支えるテクノロジーである React.JS と Elasticsearch データベースが連携することで得られる柔軟性により、Nexoid はレコード内のデータ構造にとらわれません。これにより、開発者は大きな制御と柔軟性を得ることができ、事実上あらゆるビジネスワークフローを開発できます。

当社の RESTful API は非常に包括的であるため、エンドユーザーに提供するのと同じ API を使用しています。例やステップバイステップガイドを含むドキュメントは、次の場所にあります。 https://developer.nexoid.com/api.

これが開発者以外の人にとって何を意味するのか疑問に思われるかもしれません。さて、私たちがお手伝いします。リクエストヘッダーにセキュリティトークンを隠す競合他社とは異なり、すべての安全なリクエストで単純な「session_id」変数を使用しています。これによってリクエストのセキュリティが損なわれることはありませんが、IT 運用担当者のスクリプト作成は大幅に簡略化されます。PowerShell、CURL、さらにはVBScriptなどの簡単なスクリプト言語はNexoid APIと 100% 互換性があるため、パワーユーザーはほとんど何でもできます。