認証

これは現在のTealium APIの古いバージョンです。

APIは、有効なTealiumアカウントを持つユーザーのみが使用できます。APIは、ユーザーの身元を確認するためにメールアドレスとパスワードを使用した認証をサポートしています。APIエンドポイントにアクセスする前に、セッションを開始するために認証を行う必要があります。その後のすべての呼び出しは、セキュリティ目的でセッションクッキーとCSRFトークンを使用します。

ログイン

ログインに成功すると、次の2つのアイテムが付与されます：

• JSESSIONIDという名前のクッキー。
• utkという名前のトークン。

これらの値は、その後のすべてのAPI呼び出しで認証に使用されます。

リソースURL

POST /v1/login

cURLリクエスト：

curl -i -d username='{email}' -d password='{password}' https://api.tealiumiq.com/v1/login

例のリクエスト：

curl -i -d username='user@example.com' -d password='password123' https://api.tealiumiq.com/v1/login

例のレスポンス：

HTTP/1.1 200 OK

Cache-Control: no-cache,no-store,must-revalidate
Content-Type: application/json
Date: Mon, 31 Oct 2016 20:39:29 GMT
Expires: 0
Pragma: no-cache
Set-Cookie: JSESSIONID=3513642946826543477; Path=/urest_service; Secure; HttpOnly
Set-Cookie: rememberMe=deleteMe; Path=/urest_service; Max-Age=0; Expires=Sun, 30-Oct-2016 20:39:29 GMT
X-NodeId: i-6c3ba529
X-Version: 0.0.528
X-XSS-Protection: 1;mode=block
Content-Length: 60
Connection: keep-alive

{
   "utk": "65489FMSTJGF549870KSH",
}

このレスポンスから、次の値をすべての後続のAPI呼び出しでメモしておく必要があります：

(サンプル値)

• JSESSION = 3513642946826543477
• utk = 65489FMSTJGF549870KSH

エラーメッセージ

呼び出しが失敗した場合、APIは401 Authentication Failureエラーを返します。期待されるエラーメッセージは次のとおりです：

{ <br> "returnCode" : 1401,<br> "message" : "Authentication Failed"<br>}

{ <br> "returnCode" : 1402,<br> "message" : "Too many unsuccessful login attempts. Please try again in 10 minutes" <br>}

{ <br> "returnCode" : 1469,<br> "message" : "Although the user is authenticated, the request is denied due of lack of proper permissions" <br>}

ログアウト

ログイン中のユーザーの現在のセッションを終了します。

このAPI呼び出しはオプショナルです。ユーザーのセッションが期限切れになると自動的にログアウトされます。

リソースURL

POST https://api.tealiumiq.com/v1/logout

リクエストヘッダ

例のレスポンス

ログアウトに成功すると、APIはstatus 200 OKを返します。