＜目次＞
(１) PleasanterのAPIの使い方＆レコード作成の例をご紹介
やりたいこと
(１-０) 概要
(１-１) STEP1：テスト用サイトのインポート
(１-２) STEP2：HTTPリクエストの準備
(１-３) STEP3：実行結果の確認
(１-４) 小技（Tips）
(１) PleasanterのAPIの使い方＆レコード作成の例をご紹介
やりたいこと
・PleasanterのAPIを素早く試してみたい。
(１-０) 概要
(１-１) STEP1：テスト用サイトのインポート
まずは下準備として、添付のJSONを取り込んで、テスト用のサイトを準備します。
・①「管理」→「サイトパッケージのインポート」を押下します。
（図１１１）
↓
・②添付のJSONを選択して「インポート」押下します。
（図１１２）
↓
・③サイトが作成されます。
（図１１３）
(１-２) STEP2：HTTPリクエストの準備
次にPostmanからHTTPリクエストを送るための情報をセットします。
●①HTTPメソッド、URL
（例）
https://demo.pleasanter.org/api/items/7185230/create
→「7185230」の部分はご自身のサイトIDに変更
（図１１４）
↓
●②リクエストヘッダー部
（例）
「Content-Type」に「application/json」を追加
（図１２１）
↓
●③リクエストボディ部
下記のようなJSON形式で指定します。
（例）
{
"ApiVersion": 1.1,
"ApiKey": "xxxxxxxxxx（ご自身のAPIキーを指定）",
"Title": "APIコールテスト",
"Status": "100",
"CompletionTime": "2022/12/28",
"ClassHash": {
"ClassA": "100",
"ClassB": "問い合わせ",
"ClassC": "業務システム",
"ClassD": "132173",
"ClassE": "132177"
}
}
（注意点）
・①デフォルト項目（例：タイトル＝Title、状況＝Status）はxxxxHash（例：ClassHash）の外に記述する
→xxxxHashの内部に記述してしまうと、500 Internal Server Errorになってしまいます。
・②xxxxHash（例：ClassHashなど）はClassA、ClassB、・・・の項目をカンマ区切りで羅列できる
（図１２２）
・③「組織」をプルタブで選ぶ項目の場合（[[Dept]]などを指定してる項目）、組織IDを与える。
（図１２３）ここの値をJSONの値に設定
・④APIキーはユーザーごとに発行できます。
（図１２４）
(１-３) STEP3：実行結果の確認
上記内容でリクエストを送った際の、成功例のレスポンスや更新結果の例をご紹介します。
●実行結果（成功例のレスポンス）
（例）
{
"Id": 7185272,
"StatusCode": 200,
"LimitPerDate": 10000,
"LimitRemaining": 9967,
"Message": "\" APIコールテスト \" を作成しました。"
}
（図１３１）
↓
●実行結果（画面）
⇒レコードが作成された
（図１３２）
(１-４) 小技（Tips）
ClassXなど項目に対応する物理名を素早く調べる小技をご紹介します。
・①ブラウザでF12を押して開発者ツールを開きます。
（図１４１）
・②「要素の選択」を押下します。
（図１４２）
・③この状態で調べたい項目をクリックすると、右側に出てくる「Issues_XXXX」のXXXXの部分が項目名になります。
→リクエストのボディ部で指定する名前になります。
（図１４３）
