5分で始める
APIキー取得からファーストリクエストまで
Link Grid Node APIへようこそ
Link Grid Node APIは、スマートネットワークインフラを完全にプログラマブルにする RESTful APIです。ノードの管理、トラフィックの監視、ネットワーク設定の自動化など、すべての操作をAPIを通じて実行できます。
💡 ベースURL: https://api.linkgridnode.com/v2
クイックスタート
SDKのインストール
Python, Node.js, Go対応
サンプルコード
すぐに使えるコードスニペット集
APIキーの取得
管理コンソールにログインし、設定 → API管理 → 新しいAPIキーを作成 からキーを発行します。
コピー
# 環境変数にAPIキーを設定
export LGN_API_KEY="lgn_live_xxxxxxxxxxxxxxxxxxxx"
# 接続テスト
curl -H "Authorization: Bearer $LGN_API_KEY" \
https://api.linkgridnode.com/v2/ping
export LGN_API_KEY="lgn_live_xxxxxxxxxxxxxxxxxxxx"
# 接続テスト
curl -H "Authorization: Bearer $LGN_API_KEY" \
https://api.linkgridnode.com/v2/ping
認証
すべてのAPIリクエストはHTTPヘッダーにBearerトークンを含める必要があります。
コピー
import lgn_sdk
client = lgn_sdk.Client(
api_key="lgn_live_xxxxxxxxxxxxxxxxxxxx",
region="ap-northeast-1"
)
# ネットワーク一覧を取得
networks = client.networks.list()
for net in networks:
print(f"Network: {net.name}, Status: {net.status}")
client = lgn_sdk.Client(
api_key="lgn_live_xxxxxxxxxxxxxxxxxxxx",
region="ap-northeast-1"
)
# ネットワーク一覧を取得
networks = client.networks.list()
for net in networks:
print(f"Network: {net.name}, Status: {net.status}")
ノードAPIの基本
ノードの作成、更新、削除、ステータス確認など、ノード管理に関するすべての操作をAPIで行えます。
コピー
# 新しいノードを登録
POST /v2/nodes
Content-Type: application/json
{
"name": "tokyo-node-001",
"type": "edge",
"location": {
"lat": 35.6762,
"lng": 139.6503
},
"capacity_mbps": 10000
}
POST /v2/nodes
Content-Type: application/json
{
"name": "tokyo-node-001",
"type": "edge",
"location": {
"lat": 35.6762,
"lng": 139.6503
},
"capacity_mbps": 10000
}
⚠️ レート制限: APIはデフォルトで1分あたり1000リクエストまで受け付けます。エンタープライズプランでは制限なしで利用可能です。
エラーハンドリング
APIはHTTPステータスコードとJSON形式のエラーレスポンスを返します。
コピー
{
"error": {
"code": "NODE_NOT_FOUND",
"message": "The specified node does not exist",
"request_id": "req_xxxxxxxxxxxxxxxxxxx"
}
}
"error": {
"code": "NODE_NOT_FOUND",
"message": "The specified node does not exist",
"request_id": "req_xxxxxxxxxxxxxxxxxxx"
}
}
