SigfoxクラウドAPI


Sigfox Backend Cloud APIとは

Sigfox Backend Cloud APIは、エンドポイントから、Sigfox Backend Cloudに対し、クラウドのグループ・ユーザー管理、デバイス管理を可能にするAPIです。
本APIを使用するためには、Sigfox Backend Cloudのアクセス権を取得してください。

Sigfox Backend Cloud APIの利用方法

クラウドアクセス権を取得したら、下記の方法でAPIを利用できます。(APIの利用はグループ単位です)

1.GroupタブからAPIを利用するグループを選択
2.左メニューの「API ACCESS」をクリック

3.右上の[New]ボタンをクリック

4.「Api access information」が表示されるので、NameはAPIに付ける名前(適当で結構です)、Profilesには、ログイン中のユーザーに与えられたアクセス権に該当するロールが一覧表示されます。ここでは、"DEVICE MANAGER[W]"を選択し、[OK]ボタンをクリックします。

5.設定した名前のAPIアクセス情報が表示されます。APIはBasic認証でのアクセスとなり、Login、PasswordがBasic認証の時に必要ですので、控えておいてください。また、「API documentation」をクリックすると、利用可能なAPIが表示されます。

ここで作成したAPI Credential(アカウント)は、設定したグループおよび、その配下のグループに対して有効です。

デバイスメッセージを取得するAPIを触ってみる

APIのひとつ「Messages sent by a device」を叩いてみましょう。このAPIは下記のURIになっています。ここで、{device-id}のところに、メッセージを取得したいデバイスIDを入力します。
API V2: GET https://api.sigfox.com/v2/devices/{device-id}/messages

ABCDEFというデバイスIDのメッセージを取得する場合を例に、ブラウザでAPIを叩いてみます。
ブラウザで、
https://api.sigfox.com/v2/devices/ABCDEF/messages
にアクセスすると、Basic認証の確認ダイアログが表示されます。ここで、先ほどのLogin、Passwordを入力すると、下記のようなJSONが返ってきます。

{
"data": [
  {
  "device": {
    "id": "ABCDEF"
  },
  "time": 1556780732000,
  "data": "0adb27370147ffe4002203f6",
  "rolloverCounter": 0,
  "seqNumber": 1814,
  "rinfos": [
  {
    "baseStation": {"id": "587C"},
    "delay": 1.8849999904632568,
    "lat": "36.0",
    "lng": "140.0"
  },
  {
    "baseStation": {"id": "8798"},
    "delay": 2.063999891281128,
    "lat": "36.0",
    "lng": "140.0"
  },
  {…}
  ],
  "nbFrames": 3,
  "operator": "SIGFOX_Japan_KCCS",
  "country": "JPN",
  "computedLocation": [ ],
  "lqi": 3
  },
  {...}
]}

device(デバイスID)、time(Sigfoxゲートウェイでの受信時刻:unix timestamp)、data(デバイスメッセージ)、seqNumber(シーケンス番号)に続き、rinfosという配列が続きます。このrinfosに、basestation->id(SigfoxゲートウェイのID)、delay(各ゲートウェイからSigfoxクラウドまでの遅延時間)、lat,lngは、Sigfoxゲートウェイの緯度経度(小数点以下省略)を取得できます。
この情報がメッセージ毎に続きます。
※ただし、Sigfoxクラウドへのアクセス権次第では、取得できない項目もあります。

APIで取得可能な情報

APIで取得可能な情報は、先に設定したアクセス権のロールにより異なりますが、DEVICE MANAGER[W]で取得可能な情報は下記のようなものになっています。

項目 内容
Groups グループ一覧、作成、編集、削除
Users ユーザ一覧
Device Types デバイスタイプ一覧、作成、編集、削除、デバイス登録、Callback設定
Devices デバイス編集、削除、デバイスメッセージ取得
Coverage Sigfoxサービスエリア情報

※詳しくは、公式のAPI documentationを参照ください。

Sigfox Japan KCCS