Device Intelligence APIは、コンピュータプログラム間のシームレスな通信を可能にし、自動化やサードパーティ製アプリとの統合を実現します。 このセクションでは、利用可能なAPI機能の概要と使用ガイドラインについて説明します。
地域別のAPIエンドポイント
地域に基づいた適切なAPI URL:
- US (Oregon): https://api.iotsec.goskope.com
- Germany (Frankfurt): https://api.de.iotsec.goskope.com
API URLの理解
API URLは、APIの宛先、バージョン、エンドポイントなど、いくつかの要素で構成されます。
https://api.iotsec.goskope.com/v1/integrations/custom_devicecontext
- https://api.iotsec.goskope.com → API接続先
- /v1 → APIバージョン(APIバージョンは、サポートされる機能に応じてv1またはv2になります。)
- /integrations/custom_devicecontext → API エンドポイント
API認証
Netskope Device Intelligence API 使う Basic HTTP Authentication、 client_id と secret_keyが必要です。
クレデンシャルが間違っている場合、API は次を返します。
{
"message": "Unauthorized"
}
クレデンシャルを入手するには、コンタクトNetskopeサポートまたはマーケティングチームまでお問い合わせください。
APIリクエストの作成
APIとやり取りできます:
- Command Line (cURL):
HTTPリクエストを送信し、レスポンスを受信するcurlコマンド:
curl –user '<client_id>:<secret_key>' https://api.iotsec.goskope.com - API Platforms (e.g., Postman):
使うPostmanのようなツールを使って、GETやPOSTリクエストを送信できます。 APIのURLを入力し、 Authorization type を Basic Authに設定し、クレデンシャル、client_id、secret_keyを入力します。
APIレスポンス
すべてのAPIレスポンスはJSON formatで返されます。

