データベースセッションへのログイン

共有データベースにログインするには、HTTP POST メソッドを使用して共有データベースの名前を sessions API エンドポイントで指定します。アカウント名とパスワードはヘッダの Authorization 文字列で指定されます。Claris ホストの場合、Claris Studio で設定した拡張 Claris アカウント名およびパスワードを使用します。Claris Studio ヘルプセンターの「Claris Server サービスの拡張 Claris アカウントの作成」を参照してください。アカウント名とパスワードが認証されると、コードはデータベースへの接続を定義するアクセストークンを受け取ります。この接続は「データベースセッション」と呼ばれます。

HTTP メソッド

POST

URL

/fmi/data/version/databases/database-name/sessions

version – リクエストされた FileMaker Data API のバージョン。v1、v2、または vLatest のいずれかを使用できます。

database-name – 共有データベースの名前

HTTP ヘッダ

Content-Type: application/json

Authorization: 共有データベースにログインするために使用するアカウント名とパスワードを表す Base64 エンコード文字列。Claris ホストの場合、Claris Studio で設定した拡張 Claris アカウント名およびパスワードを使用します。この Base64 エンコード文字列は標準の HTTP 基本認証スキーマに従う必要があります。(アカウント名とパスワードをコロンで区切ります。)
引数

空の中カッコ。例: { }

オプションで fmDataSource 引数を使用して外部データソースにログインすることもできます。「外部データソースへのログイン」を参照してください。
応答

アクセストークン、アクセストークンを含む応答のボディ、およびエラーコード 0 を表示するメッセージ配列。

応答で X-FM-Data-Access-Token ヘッダが返されます。これは、以降の API 呼び出しで使用するセッショントークンです。

例:

コピー 
Header:
  "X-FM-Data-Access-Token": "c4d2e429122e9cdeda19bb23c55cd2a8f282c3cc50c60943a110", 
{
Body:
  "messages": [
    {
      "message": "OK", 
      "code": "0"
    }
  ], 
  "response": {
    "token": "c4d2e429122e9cdeda19bb23c55cd2a8f282c3cc50c60943a110"
  }, 
  "HTTPMessage": "OK", 
  "HTTPCode": 200
}

「エラー応答」を参照してください。