IDパラメータで指定したユーザーをフォローします。
成功した場合は、友達になったユーザーをリクエストした形式で返します。失敗した場合は、失敗状況を説明した文字列を返します。 既にそのユーザーと友達になっている場合はHTTP 403 が返りますが、パフォーマンス上の理由から、既に友達になっていたとしても200 OKのメッセージを取得することもあります。
このメソッドの動作は非同期で行われ、変更は最終的に全て反映されます。
https://api.twitter.com/1.1/friendships/create.json
screen_name かuser_id のどちらかは必ず設定してください。
友達になるユーザーのスクリーンネーム。
サンプル値: noradio
友達になるユーザーのID。
サンプル値: 12345
対象のユーザーへの通知を有効にします。
サンプル値: true
ログインして登録アプリケーションの一覧を参照してください。
POST
https://api.twitter.com/1.1/friendships/create.json?user_id=1401881&follow=true
{
"name": "Doug Williams",
"profile_sidebar_border_color": "87BC44",
"profile_sidebar_fill_color": "F2F8FC",
"profile_background_tile": false,
"created_at": "Sun Mar 18 06:42:26 +0000 2007",
"profile_image_url": "http://a0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg",
"location": "San Francisco, CA",
"profile_link_color": "0000FF",
"follow_request_sent": false,
"is_translator": false,
"id_str": "1401881",
"entities": {
"description": {
"urls": [
]
}
},
"default_profile": false,
"url": null,
"favourites_count": 2620,
"contributors_enabled": true,
"utc_offset": -28800,
"id": 1401881,
"profile_image_url_https": "https://si0.twimg.com/profile_images/1947332700/dougw_avatar_can2_normal.jpg",
"listed_count": 890,
"profile_use_background_image": true,
"profile_text_color": "000000",
"protected": false,
"lang": "en",
"followers_count": 306557,
"geo_enabled": true,
"time_zone": "Pacific Time (US & Canada)",
"notifications": false,
"verified": false,
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg",
"profile_background_color": "9AE4E8",
"description": "Partnerships at @twitter",
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/2752608/twitter_bg_grass.jpg",
"friends_count": 1284,
"statuses_count": 11873,
"default_profile_image": false,
"status": {
"coordinates": null,
"truncated": false,
"created_at": "Sun Aug 26 21:58:35 +0000 2012",
"favorited": false,
"id_str": "239844310982459392",
"entities": {
"urls": [
],
"media": [
{
"media_url_https": "https://p.twimg.com/A1QZIU3CAAAnCkS.jpg",
"expanded_url": "http://twitter.com/dougw/status/239844310982459392/photo/1",
"sizes": {
"large": {
"w": 816,
"resize": "fit",
"h": 612
},
"medium": {
"w": 600,
"resize": "fit",
"h": 450
},
"small": {
"w": 340,
"resize": "fit",
"h": 255
},
"thumb": {
"w": 150,
"resize": "crop",
"h": 150
}
},
"id_str": "239844310986653696",
"url": "http://t.co/1uG4mhaB",
"id": 239844310986653696,
"type": "photo",
"indices": [
45,
65
],
"media_url": "http://p.twimg.com/A1QZIU3CAAAnCkS.jpg",
"display_url": "pic.twitter.com/1uG4mhaB"
}
],
"hashtags": [
],
"user_mentions": [
]
},
"in_reply_to_user_id_str": null,
"text": "Warm day by the Bay. Watching boats sail by. http://t.co/1uG4mhaB",
"contributors": null,
"id": 239844310982459392,
"retweet_count": 0,
"in_reply_to_status_id_str": null,
"geo": null,
"retweeted": false,
"in_reply_to_user_id": null,
"possibly_sensitive": false,
"place": null,
"possibly_sensitive_editable": true,
"source": "Camera on iOS",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null
},
"show_all_inline_media": true,
"screen_name": "dougw",
"following": true
}