SORACOM Bootcamp Rec6 - SORACOM Air (2) 動画はこちらをご覧ください：https://www.youtube.com/watch?v=1lgpKWP_4ww 株式会社ソラコム シニアソフトウェアエンジニア 小熊 崇

1. SORACOM Bootcamp
SORACOM Air (2)
API と CLI 実践編
株式会社ソラコム
シニアソフトウェアエンジニア
小熊 崇

2. SORACOM とは
モバイルとクラウドが融合した
IoT 向け通信プラットフォーム

3. •API を使って通信をコントロールできる
 多数のデバイスを自動で管理
数百台、数千台となってくると
むしろ API を使って自動化しないと管理不能に
“IoT 向けの通信” とは？

4. SORACOM Air – モバイル通信サービス
NTTドコモ
の交換局
API
Webコンソール
① SIMを購入して
モノに挿す
②Webから
コントロール
お客様
③APIで自動化
インターネット

5. • グループ管理
- カスタム DNS設定
- メタデータ管理
- Endorse 設定
- Funnel 設定
• イベントハンドラー管理
• 統計情報取得
• 発注
• 課金情報取得
• 支払情報登録
• メタデータ利用
• LoRaWAN 関連
140 以上の API を提供
• 認証
• オペレータ管理
- サインアップ
- メールアドレス変更
- パスワード変更
- 認証キー生成・削除
• セキュリティ情報管理
- ユーザー管理
- ロール管理
- 連携外部サービスの
認証クレデンシャル
管理
• SIM 管理
- 登録
- 通信速度変更
- アクティベート、休止
- 解約
- 有効期限管理
- タグ
- 移管
- IMEI ロック
- セッショ`ン履歴
• VPG 管理
• ログ管理
• Harvest データ管理

6. https://dev.soracom.io/jp/docs/api/
API リファレンス

7. API リファレンス デモ

8. https://dev.soracom.io/jp/docs/api_sandbox/
API Sandbox

9. • エンドポイント：
- https://api.soracom.io もしくは https://jp.api.soracom.io
- https://g.api.soracom.io
• JSON をやり取りする REST API
→ いろいろな言語から呼び出すことが可能
• リクエストヘッダーに API Key と API Token を
入れて呼び出す
- API Key：ユーザー識別
- API Token：JWT、権限のコントロール等
SORACOM API の特徴

10. curl で API を呼び出してみるデモ

11. • ほかの環境
Windows, Linux, etc.
• ほかのプログラミング言語
Ruby, Python, Swift, Java …
からも呼び出せるはず！
curl で API が呼べたということは

12. 正直なところ、面倒な感じがしませんでしたか？
 認証したり
 認証の結果得られた API Key や Token を指定し
たり
 Content-Type とかも意識しないといけない
 JSON をコマンドラインに書くの面倒
curl で呼べたけど・・・

13. https://github.com/soracom/soracom-cli
[ soracom-cli ]
Mac ユーザーの方は homebrew で以下のコマンドだけでインストール完了
brew tap soracom/soracom-cli
brew install soracom-cli
Windows / Linux ユーザーの方も GitHub のリリースページから
バイナリをダウンロードして PATH が通っているディレクトリに配置するだけ

14. soracom-cli インストール (Mac)

15. soracom-cli インストール (Windows)

16. •Linux 版は x86 (32bit), amd64 (64bit) の他に arm 版
も用意してあります
• Raspberry Pi などで実行可能
Linux 版も同様

17. 最初にやること: configure

18. SIM の一覧を取得

19. ~/.bashrc に
eval “$( soracom completion )”
補完（bash のみ対応）

20. bash コマンド補完のデモ

21. カバレッジタイプの切り替え

22. プロファイルの切り替え

23. エラー発生時

24. 非日本語環境では英語化

25. 《 まとめ 》

26. • IoT の通信は API を用いて自動で管理
• API はいろいろな環境から利用できます (REST/JSON)
• CLI もあり、簡単に使い始められます
• まだ使ったことのない方は、録画を見直してぜひ手を動か
してみてください
本日のまとめ

27. ご清聴ありがとうございました

28. SORACOM YouTube チャンネル
SORACOM YouTube 検索

29. Q. soracom-sdk-ruby にも soracom コマンドが含ま
れているようですが？
FAQ

30. Q. soracom-sdk-ruby にも soracom コマンドが含ま
れているようですが？
A. 今後は特別な理由がない限り soracom-cli をお使
いいただくことをオススメいたします。
FAQ

31. Q. API のエラーコードの一覧はありますか？
FAQ

32. Q. API のエラーコードの一覧はありますか？
A. 申し訳ございませんが用意しておりません
一般的な HTTP ステータスコードの意味に
基づいたエラーを返しておりますので
そちらをご利用ください
FAQ

33. みなさまからお寄せいただいたご質問にお答えします
都合により全ての質問にお答えできるとは限りませんのでご了承ください😌
Q&A