1 利用方法

当製品の利用方法について記載されています。

1.1 キーとシークレットの取得

SenseLinkにログインし、[System Management] > [Open Platform] へと移動してください。AppKeyとApp Secretが表示されます。

1.2 呼び出し方法

1.2.1 シグネチャ（sign）の計算

計算方法

sign=md5 (timestamp#app_secret)

により計算されます。タイムスタンプおよびAppシークレットを利用してください。

例：

app_secret=2323dsfadfewrasa3434
timestamp=1477881215000
sign=md5 (1477881215000#2323dsfadfewrasa3434) =e5ef72ef839bdf5397b4906b199b9fbf

timestamp：Unix 時間 (ミリ秒を含む13桁)

1.2.2 GET メソッドのインターフェース

sign、timestamp、および Appキー（app_key）の 3 つのパラメーターを、オプションパラメーターと共に次のようにリクエストしてください。

http://host:port/api/v1/device?typeId=10&size=100&sign=e5ef72ef839bdf5397b4906b199b9fbf&app_key=35uifanj8i30kdng&timestamp=1477881215000

TypeId および size はオプションパラメーターです。サーバーは現在の timestamp をクライアント側からのリクエスト内の timestamp と比較し、その差が30 分以上の場合はエラーを返します。

1.2.3 POST メソッドのインターフェース

sign、timestamp、およびAppキー（app_key） の 3 つのパラメーターを、次のようにリクエストしてください。

http://host:port/api/v3/device/update?sign=e5ef72ef839bdf5397b4906b199b9fbf&app_key=35uifanj8i30kdng&timestamp=1477881215000

オプションパラメーターはリクエスト本体に配置され、form-data　またはインターフェースドキュメントで指定された application/json に従って呼び出され、リクエストがサーバーへ送信されます。サーバーは現在の timestamp をクライアント側からのリクエスト内の timestamp と比較し、その差が30 分以上の場合はエラーを返します。

一部のインターフェースでは id をリクエストに配置する必要があります。詳細については、APIの利用方法をご参照ください。

1.3 API エラーコード

コード	メッセージ	原因
10001	App Key Not Exist	キーがありません
10002	App Expired	キーが期限切れです
10003	Request Expired	リクエストが期限切れです
10004	IP Invalid	IPアドレスがホワイトリストにありません
10005	Signature Failed	無効な署名です
20001	Company Out Of Date	企業の利用期間の期限が切れました
20002	Permission Denied	権限がありません
30001	Param Invalid	無効なパラメーターです
30002	Similar User Exist	追加された登録者は既存の登録者と非常に類似しています
30003	No Face Detected In The Image	写真内で顔を検出できません
30004	Missing Param	パラメーターが不足しています
30005	Avatar File Invalid	不正な写真形式です
50001	RPC Failed	サーバー同期エラー
50002	Internal Server Error	内部サーバーエラー
50003	Multi Request Error	一括リクエストエラー
50004	Request Method Not Allowed	不正なリクエストメソッドです
99999	Unknown Error	不明なエラーです
620	Record non-existent Error	不正なパラメーターです。対応するレコードが見つかりません
610	Similar record Exist	類似するレコードが存在します (同じ名前の部署が同じレベルに存在するなど)
650	Cannot delete unless include nothing	部署または従業員が配下にあるため削除できません。