API認証
BioStar Air Cloud APIはBearerトークン(JWT)ベースの認証を使用します。 APIを呼び出す前にログインしてトークンを取得し、すべてのリクエストのAuthorizationヘッダーにトークンを含める必要があります。
APIベースURL
| 環境 | Base URL |
|---|---|
| Demo | https://demo-afs-api.airfob.com/v1/ |
| Production - Europe | https://e-afs-api.airfob.com/v1/ |
| Production - Korea | https://a-afs-api.airfob.com/v1/(EU以外のすべての顧客向け) |
APIログイン手順
Postman またはプログラムからAPI呼び出しを行うことができる。
ログイン
-
Endpoint:
login -
Payload:
{
"username": "your_email",
"password": "your_password"
}
Bearerトークン(JWT)を返す。
アカウント情報の取得
-
Endpoint:
getSelfAccounts -
Authorization:Bearer Token
アクセス可能なサイトおよびアカウントの一覧を返す。
アカウントにログイン
-
Endpoint:
loginAccount -
Authorization:Bearer Token
特定サイトのトークンを返す。
ウェブブラウザでBearerトークンを取得する方法
Postmanを使わずに、ブラウザの開発者ツールで直接Bearerトークンを取得できます。
Chrome/Edge(WindowsまたはMac)
-
ウェブブラウザでF12またはCtrl/Cmd + Shift + Iを押す。
-
Network タブに移動する。
-
ページをリロードする。
-
API呼び出しを検索する。
例:
groups,login -
リストからリクエストをクリックする。
-
「Headers」タブに移動する。
-
リクエストヘッダで
Authorization: Bearer ...を探す。 -
右クリックしてトークンをコピーしてください。

Safari(Mac)
-
「開発者」メニューを有効にしてください。 Safari → Preferences → Advanced → Show Develop menuをチェックする。
-
Develop → Show Web Inspector に移動する。
-
Network タブに移動する。
-
ページをリロードする。
-
API呼び出しをフィルタリングして検査する。
-
リクエストヘッダから
Authorization: Bearerトークンをコピーする。
ブラウザからコピーしたBearerトークンはPostmanで再利用できる。 常に最新のBearerトークンを使用してください。