Item API : Create new item

POST /api/1/items.json

新しいアイテムを、指定のtab上に作成する。 画像は1個以上必須で、スポット情報、アイテムのURLは省略できる。 Facebookアカウントと連携済みユーザの場合 * facebook_share パラメータが true の場合、アイテム内容をFacebookへ投稿する * facebook_share パラメータが存在しない場合、アカウントのFacebook自動投稿設定に従う starting_date パラメータと ending_date パラメータの詳細は アイテムの有効期間について を参照。

Auth

Parameters

Key Value デフォルト値
title タイトル
description 概要
stream_id 対象とするtabのID
item_images[n] アイテム画像(1個以上必須) multipart/form-data 形式で指定する
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: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
Cookie: 
Origin: 

Body

------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="title"

title1
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="description"

description1
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="stream_id"

1019900359
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="item_images[]"; filename="sample.png"
Content-Type: image/png
Content-Length: 4323

{ Put binary contents that you want to upload }
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="place_ids[]"

446688635
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="link_url"

http://example.com/
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="facebook_share"

true
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="starting_date"

2012-12-09T01:54:06Z
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="ending_date"

2013-02-09T01:54:06Z
------------XnJLe9ZIbbGUYtzPQJ16u1--

Response

Headers

Content-Type: application/json; charset=utf-8
Set-Cookie: guest_distinct_id=7ad100bb-4d45-4247-9570-fab77738cfb0; expires=Mon, 09-Jan-2023 01:54:07 GMT
guest_distinct_id=f5c208b3-4230-401c-89d4-7903a6d809d1; expires=Mon, 09-Jan-2023 01:54:07 GMT
guest_distinct_id=94eaf35b-11a7-444f-b5e3-f11fc875165f; expires=Mon, 09-Jan-2023 01:54:07 GMT
THIS_IS_SESSION_COOKIE_KEY_FOR_SPEC=BAh7CEkiD3Nlc3Npb25faWQGOgZFRkkiJTQyNGU0OGZkMmNjZTAyMmE3ZTkyN2FjNjNjMGY4YTUyBjsAVEkiHXdhcmRlbi51c2VyLmFwaV91c2VyLmtleQY7AFRbCEkiCVVzZXIGOwBGWwZpBOhJETpJIiIkMmEkMTAkMTNFZVBUd1lhQmlYbUNhdkpJeWdXZQY7AFRJIhhrcGlfcHJldl9jb250cm9sbGVyBjsARkkiFWFwaS9pdGVtcyNjcmVhdGUGOwBG--63a76b606033ef7f49c617442c5640106c8ea7c7; path=/; HttpOnly
X-Ua-Compatible: IE=Edge,chrome=1
E-Tag: "2e0b65c22dd6544256e02933f6dfc95c"
Cache-Control: max-age=0, private, must-revalidate
X-Request: d30359667d85ebcc2c4622866c13b3ba
X-Runtime: 0.702769
Content-Length: 2772

Status

200 OK

Body

フォーマット: items/basic
{
  "item": {
    "id": 919271614,
    "title": "title1",
    "reclip_from_id": null,
    "reclip_count": 0,
    "like_count": 0,
    "origin_id": null,
    "link_url": "http://example.com/",
    "created_at": "2013-01-09T01:54:06Z",
    "updated_at": "2013-01-09T01:54:06Z",
    "description": "description1",
    "starting_date": "2012-12-09T01:54:06Z",
    "ending_date": "2013-02-09T01:54:06Z",
    "image_urls": [
      {
        "original": "http://not-real.s3.amazonaws.com/images/original/cb1a8680793af663f3cf38a8bed32a6356f8cc19.png?1357696446",
        "crop_S": "http://not-real.s3.amazonaws.com/images/crop_S/4c925cc70ea724a18c5488323bb090ec47a8ba62.jpg?1357696446",
        "crop_M": "http://not-real.s3.amazonaws.com/images/crop_M/8386545515134a9167f653f2815e04d7c26cce86.jpg?1357696446",
        "crop_M1": "http://not-real.s3.amazonaws.com/images/crop_M1/3c82a5267372d64675cbe7144c4277f3a1da800f.jpg?1357696446",
        "crop_M2": "http://not-real.s3.amazonaws.com/images/crop_M2/9ea957a94bf81fc62b97cf354211d86d16297300.jpg?1357696446",
        "crop_L": "http://not-real.s3.amazonaws.com/images/crop_L/08712035decb89d1a2b435d45264b2fc11cf21a4.jpg?1357696446",
        "crop_LL": "http://not-real.s3.amazonaws.com/images/crop_LL/985d5be49923449ce06ed7e2bbb98f0141b8bdcb.jpg?1357696446",
        "normal_L": "http://not-real.s3.amazonaws.com/images/normal_L/dd26a5d0a913a6efd5dc8a3eb8d6f0b6ceaabb73.jpg?1357696446",
        "normal_LL": "http://not-real.s3.amazonaws.com/images/normal_LL/b6c1f134eca3349178e001ad631da4827a7885a5.jpg?1357696446"
      }
    ],
    "site_url": "http://tab.do/items/919271614",
    "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:06Z",
      "is_followed": false
    },
    "remind": true
  }
}