Skip to main content

Quick Start

Quick Start（最短接続確認手順）​

以下の3ステップで接続確認が可能です。

Step1：SurveyGateアンケートへのアクセス方法の選択
Step2：SurveyGateアンケートへのアクセス
Step3：ポイント付与APIを実装する

詳細仕様は各セクションをご参照ください。

事前に必要な情報​

SurveyGate側から以下の情報を事前に受け取ってください：

  • mid (メディアID): メディアを識別するID
  • hash_secret (ハッシュシークレット): URL生成時に使用する固有キー
  • point_notify_api_key (ポイント通知APIキー): ポイント付与APIの認証キー
  • 接続先ドメイン: 本番環境・検証環境のSurveyGateドメイン

メディア側からSurveyGateへご提供いただく情報

  • point_notify_url (ポイント通知URL): ポイント通知を受け取るAPIエンドポイント

Step 1：SurveyGateアンケートへのアクセス方法の選択​

SurveyGateでは2つのアンケートアクセス方法を提供しております。 下記いずれかの方法で、アンケートへのアクセスを行ってください。

SurveyGateウェブページへアクセスする方法​

  • SurveyGateは、アンケート一覧を表示するウェブページです。
  • こちらの手法は、メディアがSurveyGateへのアクセス用URLを生成し、モニターにそのURLへアクセス（リンク・リダイレクト等）してもらう方法です。

アンケート一覧を取得する方法​

  • こちらの手法は、モニターの利用可能なアンケート情報をJSON形式で返却します。
  • 返却されたアンケート情報をもとに、メディア側でアンケート一覧を表示してもらう方法です。

Step 2：SurveyGateアンケートへのアクセス​

SurveyGateウェブページへアクセスする方法​

モニターがURLをクリックするとSurveyGateのアンケート一覧ページへ遷移します。
詳細は「SurveyGateウェブページへアクセスする方法」を参照してください。

【本番環境】
https://surveygate.jp/connect?mid={mid}&mmid={mmid}&hash={hash}

【検証環境】
https://stg.surveygate.jp/connect?mid={mid}&mmid={mmid}&hash={hash}

【SurveyGate - アンケート一覧ページ】

アンケート一覧を取得する方法​

APIを1回呼び出すことでアンケート一覧が取得できます。
詳細は「アンケート一覧を取得する方法」を参照してください。

メソッド： POST

エンドポイント： /api/v2/enquetes

リクエスト例：

{
  "mid": "panelA",
  "mmid": "monitor0000000001",
  "hash": "（hash計算仕様に従って生成した値）"
}

レスポンス例：

{
  "success": true,
  "data": {
    "answer_lock_status": 0,
    "enquetes": [
      {
        "enquete_id": "31001",
        "enquete_name": "ベーシック調査（SC+本調査）",
        "min_monitor_point": 20,
        "max_monitor_point": 80,
        "min_estimated_time": 2,
        "max_estimated_time": 4,
        "is_delay": true,
        "status": 0,
        "delivered_at": "2026-01-25T10:00:00+09:00"
      }
    ]
  }
}

Step 3：ポイント付与APIを実装する​

SurveyGateからアンケート回答完了時にポイント付与の通知が送信されます。
メディア側では、この通知を受け取るAPIエンドポイントを実装し、受信した内容を自社システムのポイント反映処理に連携します。詳細は「ポイント付与API」を参照してください。

リクエスト例：

{
  "reward_request_id": "018e1234-5678-7890-abcd-ef1234567890",
  "request_date": "2026-02-01 10:00:00",
  "points": [
    {
      "reward_no": "reward001",
      "monitor_id": "monitor0000000001",
      "point": 60,
      "enquete_id": "eq_001",
      "monitor_enquete_end_flg": 1,
      "media_fee_flg": 1,
      "point_history_text": "ベーシック調査に関するアンケート"
    }
  ]
}