Vercel管理APIガイド (v1.2)

GIIPプラットフォームは、Vercelプロジェクトの設定を管理し、デプロイ履歴を照会するためのAPIを提供します。このAPIは、基本的にSk3(JSONデータベース)インターフェースを使用してリクエストを処理します。

🔌 Vercel ステータスページへ →

📋 概要

Vercel管理APIは、GIIPに登録されたVercelプロジェクト設定の照会や、最新のデプロイ履歴のモニタリングに使用されます。

🔐 認証とセキュリティ

すべてのリクエストには、GIIP共通認証ヘッダーを含める必要があります。

• Header:

  x-giip-ak

  ,

  x-giip-sk

• Body Context: Sk3インターフェース (jsondataフィールドを使用)

📡 API詳細 (Sk3)

1. Vercel設定リストの照会 (VercelConfigsList)

• コマンド:

  text=VercelConfigsList

• jsondata:

  {"csn": 123}

  (オプション: プロジェクト識別子)
• 説明: 現在登録されているすべてのVercel設定情報と連動したVercelプロジェクト名を返します。

2. Vercel設定の生成 (VercelConfigCreate)

• コマンド:

  text=VercelConfigCreate

• jsondata:

{
  "csn": 123,
  "configName": "Production_Main",
  "vercelProjectName": "giip-next-app",
  "vercelToken": "vcl_token_...",
  "vercelTeamId": "team_xxx",
  "vercelProjectId": "prj_xxx"
}

3. Vercel設定の修正・削除 (VercelConfigUpdate / VercelConfigDelete)

• 修正:

  text=VercelConfigUpdate

  +

  {"vcId": 123, ...}

• 削除:

  text=VercelConfigDelete

  +

  {"vcSn": 123}

  (またはvcId)

4. デプロイ履歴の照会 (VercelDeploymentsList)

• コマンド:

  text=VercelDeploymentsList

• jsondata:

  {"vcId": 123, "limit": 20}

• 説明: 特定の設定(vcId)に該当するVercelデプロイリストを最新順に照会します。

🛡️ Sk3(高性能ロギング)の活用

Vercel管理APIは、設計段階から

giipApiSk3

インターフェースを標準として採用しています。すべての設定管理および照会リクエストに対して詳細な実行コンテキストとエラー追跡を提供します。

• エンドポイント:

  https://giipfaw.azurewebsites.net/api/giipApiSk3

• 利点: Vercelトークンのエラーやデプロイステータスの同期失敗時、呼び出し元のIP、User-Agent、および詳細なサーバー側スタックトレースを自動的に記録し、連携に関する問題を迅速に診断できるように支援します。
• 活用チップ:

  VercelConfigCreate

  のようにパラメータが多いリクエストを送信する際、

  jsondata

  オブジェクト構造を活用することで、複雑なトークン値を失うことなく安全に送信し、ログを残すことができます。

---

バージョン: 1.3 最終更新日: 2026-04-11 ソースファイル:

giipv3/public/help/api-vercel.ja.md

---

関連ドキュメント:

• API結果コードガイド (RstVal)