APIリファレンス概要 (v1.2)

GIIPプラットフォームのマイクロサービスおよびデータベースリソースを制御・監視するための共通API規格と認証方式をご案内します。

📋 概要

GIIP APIはRESTfulアーキテクチャの原則に従い、JSON形式を使用してリクエストを処理し、レスポンスを返します。すべてのAPIはセキュリティのためHTTPSプロトコルを通じてのみアクセス可能であり、有効なAccess KeyとSecret Keyを使用することで正常な機能呼び出しが可能になります。

🔐 認証 (Authentication)

すべてのAPIリクエストヘッダーには、以下の認証情報が含まれている必要があります。

Header Key	Description
x-giip-ak	GIIP管理者から発行された Access Key
x-giip-sk	GIIP管理者から発行された Secret Key

[!IMPORTANT] Secret Keyは外部に漏洩してはならず、クライアント側のJavaScript (JS) コードなどに直接露出しないよう、サーバー側で安全に管理する必要があります。

📡 共通レスポンス形式 (Response Format)

GIIPのすべてのAPIは、一貫したレスポンス形式を提供し、クライアント側の処理を容易にします。

{
  "RstVal": 0,
  "RstMsg": "Success",
  "Data": { ... }
}

RstVal: 成功の有無 (0: 成功, その他: エラー)
RstMsg: 成功メッセージ (エラー発生時は詳細な原因テキストを含む)
Data: リクエスト成功時に返されるデータ本文

🚀 リクエスト形式

すべてのAPIリクエストは、Azure Function呼び出し規格に従い、

application/x-www-form-urlencoded

でPOSTします。

主要なフォームデータ

フィールド	説明
text	実行するコマンド文字列
user_id	呼び出し元のユーザーID
token	セッショントークン
usertoken	実際の連動に使用されるセッショントークン

🚀 APIグループ別ガイド

分野別の詳細なAPI仕様については、以下の個別ガイドを参照してください。

サーバー管理API: インフラ資産の照会およびコマンド実行
データベースAPI: DBパフォーマンスおよびクエリ統計
イシュー管理API: 障害アラームおよびステータス更新
コスト分析API: クラウド使用量およびコスト予測
プロジェクト/ユーザーAPI: 権限および組織管理
モニタリングデータ照会API: リアルタイムCPU/MEM/Diskメトリクス、パフォーマンス履歴、プロセスリスト
ネットワークセキュリティポリシーAPI: ファイアウォールルールの照会、IP許可/遮断、ポリシーの一括適用
ネットワークトポロジー(Net3D)API: インフラ接続データの収集・転送規格 (netinv, netstat, db_connections)
システム管理API: リモートコマンド実行、エージェント制御、サーバータグ管理
KVS(キー・バリュー形式)API: factorデータ照会 (KVSFactorLast, KVSFactorList)
Vercel管理API: Vercel設定管理およびデプロイ履歴の照会
GitHub Actions管理API: GitHubリポジトリ連携およびワークフロー履歴の照会
メールサーバー管理API: SMTPサーバーの設定およびテスト送信 (管理者専用)
Sk3 (高性能ロギング) API: エージェント転送エラーの検知およびデータ整合性検証のためのHigh-fidelityロギングブリッジ
共通レスポンスおよび結果コードガイド (RstVal): tDefRstテーブルに基づいた標準結果コードの案内

🛠️ 共通エラーコード

401 Unauthorized: 認証情報が無効か期限切れの場合
403 Forbidden: 当該APIを呼び出す権限がない場合（IPベースのアクセス制御を含む）
429 Too Many Requests: リクエスト頻度制限(Rate Limit)を超過した場合
500 Internal Server Error: サーバー内部エラーおよび一時的な障害が発生した場合

📖 開発者の注意事項

エンドポイント呼び出し部:
```
src/lib/lsvrUtils.ts
```
セッション管理:
```
sessionStorage
```
の
```
user_id
```
、
```
token
```
、
```
csn
```
、
```
cname
```
などを参照
すべての連携はHTTPSを基本とします。

バージョン: 1.2 最終更新日: 2026-04-11 マークダウン原文: giipv3/public/help/api-reference.ja.md