文章转自:https://www.jianshu.com/p/2c208994ff9a
本系列是对推特开发者文档进行的翻译,以便帮助开发人员使用API接口,难免有些地方存在不足,还请谅解。
关于如何获得一个推特开发者账号请看此贴:
推特开发者账号的申请
或
搜索微信公众号 推特开发者 获得帮助
Post, retrieve, and engage with Tweets
通过以下API接口可以通过编程的方式创建、检索和删除Tweets、Retweets和Like:
Tweets(发推文) | Retweets(转推) | Likes(点赞) |
---|---|---|
POST statuses/update POST statuses/destroy/:id GET statuses/show/:id GET statuses/oembed GET statuses/lookup |
POST statuses/retweet/:id POST statuses/unretweet/:id GET statuses/retweets/:id GET statuses/retweets_of_me GET statuses/retweeters/ids |
POST favorites/create/:id POST favorites/destroy/:id GET favorites/list |
有关更多详细信息,请参阅 API文档部分中的各个端口信息 。
示例
通过API发推文
对于每次更新尝试,都会将更新文本与验证用户的最新推文进行比较。 任何可能导致重复的尝试都将被阻止,从而导致403错误。 用户不能连续两次提交相同的状态。(一次POST有且仅生效一次)
尽管不受API的速率限制,但用户一次只能创建的Tweets数量受到限制。 如果用户发布的更新数量达到当前允许的限制,则此方法将返回HTTP 403错误。
关于地理位置
- 如果为用户提供的
geo_enabled
为false(此设置是所有用户的默认设置,除非用户已在其设置中启用地理定位),更新中的所有地理标记参数都将被忽略。 lat
跟踪传递给小数点分隔符后的位数(最多8位),以便当lat
在状态对象中返回时,小数点分隔符后将具有相同的位数。- 使用小数点作为纬度和经度的分隔符(而不是小数逗号)
- 对于JSON,响应主要使用GeoJSON中描述的约定。 但是,Twitter渲染的
geo
对象坐标与GeoJSON规范相反。 GeoJSON指定了一个经度然后是一个纬度,而Twitter则将其表示为一个纬度然后是经度:“ geo”:{“ type”:“ Point”,“ coordinates”:[37.78217,-122.40062]}
coordinates
对象将替换geo
对象(尚未设置geo对象的弃用日期)-区别在于,coordinates对象(以JSON)现在可以在GeoJSON中正确呈现。- 如果将
place_id
传递到状态更新中,则该位置将附加到状态中。 如果未明确提供place_id
,但提供了纬度和经度,则API会尝试通过调用geo / reverse_geocode
隐式提供位置。 - 用户可以通过用户设置页面从其所有推文中删除所有地理标签。 目前,尚无从单个Tweet移除地理标签的方法。
接口url
https://api.twitter.com/1.1/statuses/update.json