2021年9月6日

アンケート回答データ取得

Poster Developer Document

アンケート回答データ取得API

{survey_id}で指定したアンケートの回答データを50件ずつ取得します。
全ての回答データを取得するには{page}を1から{lastPage}まで順に指定して必要な回数リクエストして下さい。

前回取得した続きのデータを取得する場合、前回取得時のページ番号と取得済み回答データの{answer_id}を保持しておき、
前回取得したページ番号から取得を開始し、既に取得済みの{answer_id}のデータを除外するなどの処理を行なって下さい。

エンドポイント

URL	https://poster.ooo/api/v1/survey/{survey_id}/answer/{page}
Method	GET

Header

X-POSTER-CLIENT-ID	Posterから発行された40文字の文字列（Poster管理画面から確認して下さい。）
X-POSTER-CLIENT-SECRET	Posterから発行された80文字の文字列（Poster管理画面から確認して下さい。）

Request

パラメータ名	型	説明
URLの{survey_id}部分にセット	数字	作成済みアンケートのID
URLの{page}部分にセット	数字	取得するデータのページ番号（省略した場合は1）

ResponseBody (JSON)

※右にスクロールできます。

送信方法

型

説明

survey_id

数字

アンケートID

survey_name

文字列

アンケート名

total

数字

総回答数

count

数字

data配列に含まれる回答件数

currentPage

数字

取得した回答データのページ番号

lastPage

数字

取得可能な回答データの最終ページ番号

数字

続きの回答データを取得する際のページ番号

data

オブジェクトの配列

回答データオブジェクト

パラメータ名型	説明
answer_id 数字	回答ID ※同一ユーザーの回答であっても回答ごとにユニークな値となります
user_id 数字	回答者のPoster上のユーザーID
answered_at 文字列	回答日時(YYYY-MM-DD HH:ii:ss)
answers オブジェクト	設問IDをキーとして回答内容を文字列の配列で値に持つオブジェクト

Responseデータサンプル

{
    "survey_id": 9999999999,
    "survey_name": "アンケート",
    "total": 130,
    "currentPage": 1,
    "lastPage": 3,
    "nextPage": 2,
    "count": 50,
    "data": [
        {
            "answer_id": 1234567890,
            "user_id": 1111111111,
            "answerd_at": "2021-10-01 09:50:45",
            "answers": {
                "abcde111111111.22222222": [
                    "ウェブ広告","チラシ"
                ]
            }
        },
        {
            "answer_id": 1234567891,
            "user_id": 2222222222,
            "answerd_at": "2021-10-02 10:05:20",
            "answers": {
                "abcde111111111.22222222": [
                    "ウェブ広告","その他"
                ],
                "abcde123456789.01234567": [
                    "検索サイト"
                ]
            }
        },
        {…}
    ]
}

一覧リスト