ステップ 1: API で認証する
コールを発行する前に API で認証する必要があります。
API が現在サポートしているのは、基本認証メカニズムのみです。後続の API コールで使用する認証トークンを取得するには、最初に認証サービスに対してコールを実行する必要があります。
1https://api-endpoint/auth/authenticateこのコールでは、認証チェックのための次の要求ヘッダーが返されます。
| パラメータ | 説明 |
|---|---|
| auth_user | アカウントのユーザ名 |
| auth_pass | プレーンテキストのパスワード |
| auth_appkey | ヘッダーパラメータに含める API キー |
すべてのパラメータは必須です。認証が成功すると、基本的なユーザアカウント情報とトークンタグが含まれる XML が次の形式で返されます。
1<token>70d756801c703f3e78f81726c11b00249fb81770a446958b2577cd223811e</token>このトークンを使用して、後続の API 要求を実行します。
1<auth>
2
3 <token>e008252b4dce9b29c4c8155f0010cc8e128290b9e3ae99c8e9d15c
4
5 </token>
6
7 <UserDetails>
8
9 <user>
10
11 <userId>132972</userId>
12
13 <clientId>1226</clientId>
14
15 <displayName>Joe User</displayName>
16
17 <emailAddress>joe.user@radian6.com</emailAddress>
18
19 <packages />
20
21 </user>
22
23 <Packages>
24
25 <feature>
26
27 <featureId>1</featureId>
28
29 <description>Workflow</description>
30
31 </feature>
32
33 <feature>
34
35 <featureId>4</featureId>
36
37 <description>Admin Portal Full</description>
38
39 </feature>
40
41 <feature>
42
43 <featureId>6</featureId>
44
45 <description>Require PO Number</description>
46
47 </feature>
48
49 <feature>
50
51 <featureId>8</featureId>
52
53 <description>SENTIMENT</description>
54
55 </feature>
56
57 </Packages>
58
59 </UserDetails>
60
61 </auth>