補助金AI REST API ドキュメント

すべてのAPIリクエストには、Authorizationヘッダーに Bearer トークンとしてAPIキーを含める必要があります。 APIキーはパートナーダッシュボードのAPIキー管理ページから発行できます。

curl -H "Authorization: Bearer hojo_xxxxxxxxxxxx" \
  https://hojokin.xyz/api/v1/projects/YOUR_PROJECT_ID

リクエストボディ

{
  "subsidyType": "jizokuka",  // "jizokuka" | "monodzukuri"
  "inputData": {
    "step1": {
      "companyName": "株式会社サンプル",
      "representativeName": "山田太郎",
      "industry": "retail",
      "industryDetail": "食料品小売業",
      "location": "東京都新宿区",
      "employeeCount": 5,
      "foundingYear": 2010,
      "businessDescription": "地域密着型の食料品店を経営"
    },
    "step2": {
      "mainProducts": "生鮮食品、加工食品の販売",
      "customerBase": "近隣住民（50代以上が中心）",
      "annualRevenue": 50000000,
      "annualProfit": 3000000,
      "salesMethods": "店舗販売のみ",
      "websiteUrl": "",
      "currentSituation": "来店客数が年々減少している"
    },
    "step3": {
      "strengths": "地域での知名度が高い",
      "weaknesses": "ECサイトがない",
      "opportunities": "コロナ後のネット購買需要",
      "threats": "大手スーパーの出店",
      "differentiation": "地元農家との直接取引"
    },
    "step4": {
      "projectName": "ECサイト構築による販路開拓",
      "projectDetail": "自社ECサイトを構築し、地元農産物のオンライン販売を開始する",
      "itUtilization": "Shopifyを活用したECサイト構築",
      "businessDirection": "オンライン販売比率を30%まで引き上げる",
      "expectedEffect": "年間売上20%増加を目指す"
    },
    "step5": {
      "expenses": [
        {
          "category": "広報費",
          "description": "ECサイト構築費",
          "quantity": 1,
          "unitPrice": 500000,
          "amount": 500000
        }
      ],
      "totalExpense": 500000,
      "subsidyAmount": 333333,
      "appliedCategory": "一般型",
      "currentRevenue": 50000000,
      "currentAddedValue": 8000000,
      "currentTotalSalary": 6000000,
      "selfFunding": 166667
    }
  }
}

レスポンス (202 Accepted)

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "generating"
}

curl の例

curl -X POST https://hojokin.xyz/api/v1/generate \
  -H "Authorization: Bearer hojo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "subsidyType": "jizokuka",
    "inputData": { ... }
  }'

レスポンス (200 OK)

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "subsidyType": "jizokuka",
  "status": "completed",  // "generating" | "preview_ready" | "completed" 等
  "title": "ECサイト構築による販路開拓",
  "createdAt": "2026-03-19T10:00:00.000Z",
  "sections": {
    "companyOverview": "...",
    "customerNeeds": "...",
    "strengths": "...",
    "businessDirection": "...",
    "projectName": "...",
    "projectDetail": "...",
    "efficiencyPlan": "...",
    "projectEffect": "...",
    "expenseDetail": "...",
    "fundingPlan": "..."
  },
  "scoreResult": {
    "totalScore": 85,
    "maxScore": 100,
    "criteria": [...],
    "overallAssessment": "...",
    "improvements": [...]
  }
}

curl の例

curl https://hojokin.xyz/api/v1/projects/YOUR_PROJECT_ID \
  -H "Authorization: Bearer hojo_your_api_key_here"

ポーリングの推奨パターン

生成には2〜5分かかります。status が "generating" の間は 10〜30秒間隔でポーリングしてください。

# ポーリング例（bash）
while true; do
  STATUS=$(curl -s \
    -H "Authorization: Bearer hojo_your_api_key_here" \
    https://hojokin.xyz/api/v1/projects/YOUR_PROJECT_ID \
    | jq -r '.status')

  echo "Status: $STATUS"

  if [ "$STATUS" != "generating" ]; then
    echo "生成完了"
    break
  fi

  sleep 15
done

レスポンス

Content-Type: application/pdf のバイナリレスポンスが返されます。

curl の例

curl -o business-plan.pdf \
  -H "Authorization: Bearer hojo_your_api_key_here" \
  https://hojokin.xyz/api/v1/projects/YOUR_PROJECT_ID/pdf