KayaMemo

前回、Typeformを触ってみたけれど、
APIがあるとのことなので見てみました。

公式ページ(英語)
http://helpcenter.typeform.com/hc/en-us/articles/200071986-Data-API

認証や何やらは全くなくて、
取得したAPIキーとアンケートIDを使用して、URLから直接JSONを取得する形式。
逆に言えば、URLさえわかれば誰でもアクセス出来てしまうので、
あまり個人情報的な内容を書かせてしまうと、セキュリティ的にまずいのかもしれない。
(キーはどちらも推測はされにくいとは思いますが)

APIキーは、My Account内の、Your API Keyにあります。

このキーを利用して、以下のよう書式で記述します。

https://api.typeform.com/v0/form/アンケートID?key=自分のAPIキー

すると、以下の様なレスポンスがあります。

{
    "http_status": 200, 
    "questions": [
        {
            "id": "rating_1595673", 
            "question": "イベントを評価して下さい"
        }, 
        {
            "id": "list_1595676_choice", 
            "question": "面白かったですか？"
        }, 
        {
            "id": "textarea_1595680", 
            "question": "何かあれば記入して下さい"
        }
    ], 
    "responses": [
        {
            "answers": {
                "list_1595676_choice": "楽しかった", 
                "rating_1595673": "3", 
                "textarea_1595680": "ぜひまた開催をお願い致します。"
            }, 
            "completed": "1", 
            "hidden": [], 
            "id": "3", 
            "locked": "0", 
            "metadata": {
                "browser": "default", 
                "date_land": "2014-08-29 13:00:43", 
                "date_submit": "2014-08-29 13:01:09", 
                "network_id": "xxxxxx", 
                "platform": "other", 
                "referer": "", 
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_5)   AppleWebKit/537.75.14 (KHTML, like Gecko) Version/6.1.3 Safari/537.75.14"
            }, 
            "token": "xxxxxx"
        }, 
         {
            …中略
        }
    ], 
    "stats": {
        "responses": {
            "completed": 2, 
            "locked": 0, 
            "showing": 2, 
            "total": 10
        }
    }
}

オプションは以下。

項目	型	説明
completed	boolean	true:完了している項目のみ false:完了していないもののみ
since	number (Unix time/Timestamp)	指定した日付より後
until	number (Unix time/Timestamp)	指定した日付まで
offset	number	(ページがある場合)何ページ目から始めるか
limit	number	1ページの表示件数

アンケート作成用のAPIは現在開発中だそうです。
http://helpcenter.typeform.com/hc/en-us/articles/200070236-Build-API-coming-soon-