1 製品概要と利用方法

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

1.1 製品概要

本ドキュメントは、主に開発者の方々に利用いただくSenseLink GE EnterpriseのAPIマニュアルです 。

SenseLink GE Open Platformは、SenseLink に基づくオープンサービスプラットフォームです。 サードパーティのシステムはSenseLinkからデバイス、登録者、レコードなどの情報を取得し、SenseLinkが持つ管理機能をすばやく統合できます。

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

SenseLinkにログインし、ナビゲーションメニューの[システム管理] → [Open Platform] を選択してください。AppキーとAppシークレットを管理するOpen Platform画面が表示されます。

1.2.1 キーとシークレットの作成と管理

AppキーやAppシークレットを作成するには、Open Platform画面の[App Keyを作る]ボタンをクリックしてください。このとき、確認のためにパスワードを入力する必要があります。表示される入力画面に現在ログイン中のアカウントのパスワードを入力して、確認ボタンをクリックしてください。

「AppキーとAppシークレットを作成しました。ダウンロードされたCSV内にAppキーとAppシークレットの情報が含まれます。安全に管理してください。」というメッセージが表示され、利用中のPCにAppキーとAppシークレットが記載されたCSVファイルがダウンロードされます。ダウンロードされたCSVファイルを開くと、AppキーとAppシークレットの内容を確認することができます。 なお、入力したパスワードが誤っている場合、AppキーとAppシークレットは作成されず、CSVファイルもダウンロードされません。

また、Web画面上の一覧から作成したAppキーとAppシークレットを確認することができます。Appシークレットはデフォルトで非表示になっています。表示ボタンをクリックすると、パスワード入力を求められます。現在ログイン中のアカウントのパスワードを入力すると、Appシークレットが表示されます。

Appキーは5つまで作成および利用可能で、それぞれ無効化したり、削除もできます。一覧表示画面にある設定ボタンを利用することで管理できます。 無効化中はAppキーとAppシークレットが利用できませんが、有効化するともう一度同じAppキーとAppシークレットが利用可能です。ただし一度削除するとAppキーとAppシークレットを復元することはできませんので、ご注意ください。

1.2.2 ドメイン管理

APIは、第三者から不正アクセスを防止し、セキュリティを向上するため、登録したドメインからのみ利用可能となっています。 まず、OpenAPIアクセス制限設定を有効にしてください。詳細は運用マニュアルの4章をご参照ください。 APIキーを作成すると、Open Platform画面の[ドメインを追加]ボタンがアクティブになります。[ドメインを追加]ボタンをクリックして必要なドメインを入力し、適用ボタンをクリックしてください。登録したドメインからAPIを利用できます。

1.3 呼び出し方法

1.3.1 シグネチャ(sign)の計算

計算方法は、

sign=md5 (timestamp#app_secret)

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

例:

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

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

1.3.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.3.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.4 API エラーコード

コード

メッセージ

原因

10001

App Key Not Exist

キーがありません

10002

App Expired

キーが期限切れです

10003

Request Expired

リクエストが期限切れです

10004

IP Invalid

IPアドレスが許可リストにありません

10005

Signature Failed

無効なシグネチャ(sign)です

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

不正なリクエストメソッドです

60005

Request_rate_too_high

リクエスト頻度が高すぎます

60006

Daily_quota_exceeded

1 日あたりのリクエスト上限に達しました

99999

Unknown Error

不明なエラーです

620

Record non-existent Error

不正なパラメーターです。対応するレコードが見つかりません

610

Similar record Exist

類似するレコードが存在します(同じ名前の部署が同じレベルに存在するなど)

650

Cannot delete unless include nothing

部署または従業員が配下にあるため削除できません

最終更新