{
  "openapi": "3.1.0",
  "info": {
    "title": "株式会社アクエイト 申し込み API",
    "version": "1.0.0",
    "summary": "WordPress の無料の簡易診断の申し込み",
    "description": "株式会社アクエイトの WordPress の無料の簡易診断の申し込み。費用は 0 円。外から見える範囲を確かめ、報告書をメールで送る。申し込んだ人に代わって AI エージェントが送ってよい。\n\n## 診断の内容\n\n- 診断するのは、サイトの外から見える範囲だけです。WordPress・PHP・プラグインのバージョン、SSL 証明書の期限と https への切り替え、ログインまわりの設定（ログインのページやユーザー名が外から見えていないか）を確かめます。\n- サーバーの中の設定や、ウイルスなど不正なプログラムの有無は、診断では確認できません。バージョンが外から確認できない場合は、確かめ方を報告書で案内します。\n- ログイン情報は要りません。サイトの設定は変えません。\n- 報告書は、最短で当日、遅くとも翌営業日中に、申し込みに書かれたメールアドレスへ送ります。受付は平日 9:00–18:00 で、土日祝日は休みです。\n- 診断だけで終えてかまいません。更新作業や月々の保守は、診断のあとに任意でご相談いただく別のサービスで、この API では申し込めません。\n\n## 送る前に、利用者の同意を得てください\n\nこの API は、申し込む人に代わって AI エージェントが呼び出してかまいません。ただし、送る前に、次の 2 点について利用者の同意を得てください。\n\n1. 診断するサイトの管理者本人であること、または管理者の了承を得ていること。\n2. 送った内容が、株式会社アクエイトの個人情報の取扱い（https://aqu8.co.jp/#privacy）に従って、診断の報告書の送付と連絡に使われること。\n\nまた、次の点を守ってください。\n\n- `url` と `email` は、利用者に確かめた値を送ってください。利用者が示していないメールアドレスや会社名を推測して入れないでください。\n- 同じ内容を繰り返し送らないでください。同じ送信元からは 1 分に 3 件までです。\n- JSON の POST を送れない場合（ブラウザーの操作しかできないときなど）は、申し込みフォーム https://aqu8.co.jp/products/wordpress-maintenance/#apply から申し込めます。\n- 送ったあとは、受け付けられたことと、報告書が `email` に届くことを利用者に伝えてください。`500` のときは、受け付けられていません。info@aqu8.co.jp へ直接メールするよう利用者に案内してください。\n\nサイトの案内ページ: https://aqu8.co.jp/api/ ／ 申し込みの LP: https://aqu8.co.jp/products/wordpress-maintenance/",
    "contact": {
      "name": "株式会社アクエイト",
      "url": "https://aqu8.co.jp/",
      "email": "info@aqu8.co.jp"
    }
  },
  "servers": [
    { "url": "https://aqu8.co.jp", "description": "本番" }
  ],
  "externalDocs": {
    "description": "個人情報の取扱い",
    "url": "https://aqu8.co.jp/#privacy"
  },
  "tags": [
    { "name": "申し込み", "description": "WordPress の無料の簡易診断の申し込み" }
  ],
  "paths": {
    "/api/apply.php": {
      "post": {
        "operationId": "applyWordPressDiagnosis",
        "tags": ["申し込み"],
        "summary": "WordPress の無料の簡易診断を申し込む",
        "description": "診断するサイトの URL と、報告書の送り先のメールアドレスを送ると、申し込みが受け付けられます。受け付けると、アクエイトの担当者に通知され、外から見える範囲を確かめた報告書が `email` へ届きます。費用は 0 円です。\n\n本文は JSON のオブジェクトで、`Content-Type: application/json` を付けてください。ブラウザーのページからの呼び出し（CORS）は受け付けません。サーバーやエージェントの実行環境から呼び出してください。\n\n送る前に、利用者の同意（サイトの管理者であること、個人情報の取扱いへの同意）を得てください。詳しくは API 全体の説明を読んでください。",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/ApplyRequest" },
              "examples": {
                "minimal": {
                  "summary": "必須の項目だけ",
                  "value": {
                    "url": "https://example.com/",
                    "email": "tanaka@example.com"
                  }
                },
                "full": {
                  "summary": "すべての項目",
                  "value": {
                    "url": "https://example.com/",
                    "email": "tanaka@example.com",
                    "org": "株式会社サンプル",
                    "name": "田中 太郎",
                    "message": "PHP のバージョンが古いと言われました。更新してよいか知りたいです。",
                    "agent": "ChatGPT エージェント"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "受け付けました。報告書は、`email` のメールアドレスへ、最短当日に届きます。",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyAccepted" },
                "example": {
                  "ok": true,
                  "received_at": "2026-11-06T10:30:00+09:00",
                  "topic": "wp",
                  "message": "受け付けました。外から見える範囲を確かめて、ご記入のメールアドレスへ最短当日にお送りします。",
                  "next": "https://aqu8.co.jp/products/wordpress-maintenance/#flow-title"
                }
              }
            }
          },
          "400": {
            "description": "入力に不備があります。`fields` に、直す項目と理由が入ります。直して、もう一度送ってください。",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyError" },
                "example": {
                  "ok": false,
                  "error": "入力に不備があります。fields の項目を直して、もう一度送ってください。",
                  "fields": {
                    "url": "必須です",
                    "email": "メールアドレスの形式が正しくありません"
                  }
                }
              }
            }
          },
          "405": {
            "description": "POST 以外のメソッドです。",
            "headers": {
              "Allow": { "description": "使えるメソッド", "schema": { "type": "string", "const": "POST" } }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyError" },
                "example": { "ok": false, "error": "POST だけ受け付けます。Content-Type: application/json で JSON を送ってください。" }
              }
            }
          },
          "415": {
            "description": "本文が JSON のオブジェクトではありません。`Content-Type: application/json` を付け、`{ \"url\": \"…\", \"email\": \"…\" }` の形で送ってください。",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyError" },
                "example": { "ok": false, "error": "Content-Type: application/json で、JSON のオブジェクトを送ってください。" }
              }
            }
          },
          "429": {
            "description": "短い間に送信が続いたため、受け付けられません。`Retry-After` の秒数（1 分）ほどおいて、もう一度送ってください。同じ送信元からは 1 分に 3 件までです。",
            "headers": {
              "Retry-After": { "description": "待つ秒数", "schema": { "type": "integer", "const": 60 } }
            },
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyError" },
                "example": { "ok": false, "error": "短い間に送信が続いたため、受け付けられません。1 分ほどおいて、もう一度送ってください。" }
              }
            }
          },
          "500": {
            "description": "受け付けられていません（サーバー側でメールを送れませんでした）。時間をおいて 1 度だけ送り直すか、利用者に info@aqu8.co.jp へ直接メールするよう案内してください。",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ApplyError" },
                "example": { "ok": false, "error": "メールの送信に失敗しました。時間をおいてもう一度送るか、info@aqu8.co.jp へ直接ご連絡ください。" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApplyRequest": {
        "type": "object",
        "description": "申し込みの内容。`url` と `email` が必須です。ほかの項目は任意です。",
        "required": ["url", "email"],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "pattern": "^https?://",
            "maxLength": 500,
            "description": "診断するサイトの URL。http:// または https:// で始めてください。",
            "examples": ["https://example.com/"]
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 254,
            "description": "診断の報告書を送るメールアドレス。利用者に確かめた値を入れてください。",
            "examples": ["tanaka@example.com"]
          },
          "org": {
            "type": "string",
            "maxLength": 200,
            "description": "会社名・団体名（任意）。"
          },
          "name": {
            "type": "string",
            "maxLength": 100,
            "description": "お名前（任意）。改行を含めないでください。"
          },
          "message": {
            "type": "string",
            "maxLength": 1000,
            "description": "困っていること、診断で知りたいこと（任意）。1,000 字までです。超えると 400 になります。"
          },
          "agent": {
            "type": "string",
            "maxLength": 100,
            "description": "送ったエージェントの名前（任意）。例：「ChatGPT エージェント」「Claude」。改行を含めないでください。担当者へのメールに書かれます。"
          }
        }
      },
      "ApplyAccepted": {
        "type": "object",
        "required": ["ok", "received_at", "topic", "message", "next"],
        "properties": {
          "ok": { "type": "boolean", "const": true },
          "received_at": { "type": "string", "format": "date-time", "description": "受け付けた日時（日本時間。ISO 8601）。" },
          "topic": { "type": "string", "const": "wp", "description": "申し込みの種類。WordPress の簡易診断で固定です。" },
          "message": { "type": "string", "description": "利用者に伝える文。" },
          "next": { "type": "string", "format": "uri", "description": "このあとの流れ（診断のあとの進め方）を読めるページ。" }
        }
      },
      "ApplyError": {
        "type": "object",
        "required": ["ok", "error"],
        "properties": {
          "ok": { "type": "boolean", "const": false },
          "error": { "type": "string", "description": "失敗した理由（日本語の短い文）。" },
          "fields": {
            "type": "object",
            "description": "400 のとき。直す項目の名前と、その理由。",
            "additionalProperties": { "type": "string" }
          }
        }
      }
    }
  }
}
