Item API

指定のアイテムを自分のtabに入れる。画像は変更できないが、タイトルや概要、スポット情報、URLなどは変更することができる。 Facebookアカウントと連携済みユーザの場合 * facebook_share パラメータが true の場合、アイテム内容をFacebookへ投稿する * facebook_share パラメータが存在しない場合、アカウントのFacebook自動投稿設定に従う starting_date パラメータと ending_date パラメータの詳細はアイテムの有効期間についてを参照。

Auth

ユーザ認証が必要

Parameters

Key	Value	デフォルト値
reclip_from_id	tabに入れる対象アイテムのID
title	タイトル
description	概要
stream_id	tabのID
place_ids[n]	アイテムが位置するスポットのID(0個以上)。スポットグループのID指定があれば無視される
place_group_id	アイテムが位置するスポットグループのID。スポットのID指定よりも優先される
link_url	アイテムのURL
facebook_share	Facebook投稿の有効・無効 (true or false)	アカウント毎の設定
facebook_comment	Facebook投稿時のコメント内容。Facebook投稿が有効である場合のみ利用される
remind	近隣アイテム通知の有効・無効 (true or false)	true
starting_date	アイテムの有効期間開始日時。利用可能な時期が限られている場合に指定
ending_date	アイテムの有効期間終了日時。利用可能な時期が限られている場合に指定

Request

Route

POST /api/1/items.json

Headers

Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 
Origin:

Body

reclip_from_id=385925939
title=新宿ふんどし祭り
description=男たちがふんどしで踊り狂う！
stream_id=1019900359
place_ids[]=446688635
link_url=http://example.com/
facebook_share=true
starting_date=2012-12-09T01:54:07Z
ending_date=2013-02-09T01:54:07Z

Response

Headers

Content-Type: application/json; charset=utf-8
Set-Cookie: guest_distinct_id=05f480f8-651a-44be-9741-2fbf22f00801; expires=Mon, 09-Jan-2023 01:54:07 GMT
guest_distinct_id=afd38fac-a538-4f6e-a7f1-67f6f8b48574; expires=Mon, 09-Jan-2023 01:54:07 GMT
guest_distinct_id=73ffe503-da70-4cc5-9237-fe6251235e81; expires=Mon, 09-Jan-2023 01:54:07 GMT
THIS_IS_SESSION_COOKIE_KEY_FOR_SPEC=BAh7CEkiD3Nlc3Npb25faWQGOgZFRkkiJThmNDdlOTdkYzU1YzljNWE1NGY2NzAxODE1ZThkM2E5BjsAVEkiHXdhcmRlbi51c2VyLmFwaV91c2VyLmtleQY7AFRbCEkiCVVzZXIGOwBGWwZpBOhJETpJIiIkMmEkMTAkMTNFZVBUd1lhQmlYbUNhdkpJeWdXZQY7AFRJIhhrcGlfcHJldl9jb250cm9sbGVyBjsARkkiFWFwaS9pdGVtcyNjcmVhdGUGOwBG--38e4fe8a94ecc2a5ea6f7a4b76a39f42b487f819; path=/; HttpOnly
X-Ua-Compatible: IE=Edge,chrome=1
E-Tag: "d927ad5a5766a6053905b0dcfb730ee3"
Cache-Control: max-age=0, private, must-revalidate
X-Request: ceb4d6a1a36d518ea80e1399aabb2c8e
X-Runtime: 0.149917
Content-Length: 2830

Status

200 OK

Body

フォーマット: items/basic_reclip

{
  "item": {
    "id": 919271615,
    "title": "新宿ふんどし祭り",
    "reclip_from_id": 385925939,
    "reclip_count": 0,
    "like_count": 0,
    "origin_id": 385925939,
    "link_url": "http://example.com/",
    "created_at": "2013-01-09T01:54:07Z",
    "updated_at": "2013-01-09T01:54:07Z",
    "description": "男たちがふんどしで踊り狂う！",
    "starting_date": "2012-12-09T01:54:07Z",
    "ending_date": "2013-02-09T01:54:07Z",
    "image_urls": [
      {
        "original": "http://not-real.s3.amazonaws.com/images/original/f72a75c77675cb0f3452b176cd0232c12ccab759.png?1357696443",
        "crop_S": "http://not-real.s3.amazonaws.com/images/crop_S/967f6ad0e57b9cdc251676fa6a89ac2a26e7b6b6.jpg?1357696443",
        "crop_M": "http://not-real.s3.amazonaws.com/images/crop_M/0078d956d348c740241a5f81a50c0fbd7abe65b4.jpg?1357696443",
        "crop_M1": "http://not-real.s3.amazonaws.com/images/crop_M1/93c649fc2462a2cb87d82d608f2cef5c015d0883.jpg?1357696443",
        "crop_M2": "http://not-real.s3.amazonaws.com/images/crop_M2/dd53d388a6a6c06cb6a38de3e645443778e38973.jpg?1357696443",
        "crop_L": "http://not-real.s3.amazonaws.com/images/crop_L/ba1e73a5d5c95b6683f18f217adccb09e5bb3dc6.jpg?1357696443",
        "crop_LL": "http://not-real.s3.amazonaws.com/images/crop_LL/d553d7013c1bbc39a963b1bda6d834b25fb8d4a5.jpg?1357696443",
        "normal_L": "http://not-real.s3.amazonaws.com/images/normal_L/4a6dd79cb1be896e2c70e5b1bae5dd86743fde6d.jpg?1357696443",
        "normal_LL": "http://not-real.s3.amazonaws.com/images/normal_LL/736c95fda936e55fdc881fa36d41872a1d39fed5.jpg?1357696443"
      }
    ],
    "site_url": "http://tab.do/items/919271615",
    "user": {
      "id": 974211560,
      "screen_name": "Iguchi Takahito",
      "profile_image_url": {
        "original": "http://sc2-items-dev.s3.amazonaws.com/profile_images/original/missing.png?t=1",
        "crop_S": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_S/missing.png?t=1",
        "crop_M": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M/missing.png?t=1",
        "crop_M1": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M1/missing.png?t=1",
        "crop_M2": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_M2/missing.png?t=1",
        "crop_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_L/missing.png?t=1",
        "crop_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/crop_LL/missing.png?t=1",
        "normal_L": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_L/missing.png?t=1",
        "normal_LL": "http://sc2-items-dev.s3.amazonaws.com/profile_images/normal_LL/missing.png?t=1"
      }
    },
    "places": [
      {
        "id": 446688635,
        "name": "ハチ公前",
        "address": "東京都渋谷区道玄坂1-1-1",
        "description": null,
        "lon": 139.70056861639023,
        "lat": 35.65906149699357,
        "created_at": "2013-01-09T01:54:04Z",
        "updated_at": "2013-01-09T01:54:04Z"
      }
    ],
    "area": {
      "id": 317713213,
      "name": "渋谷駅"
    },
    "stream": {
      "id": 1019900359,
      "title": "iguchi bicycle",
      "followers_count": 1,
      "description": "自転車がいっぱい",
      "latest_used": "2013-01-09T01:54:07Z",
      "is_followed": false
    },
    "remind": true
  }
}

Item API : put an item to tab

Auth

Parameters

Request

Route

Headers

Body

Response

Headers

Status

Body