Change Log
Version 2.1
General Changes
- All methods are now available under the /2.1/ path, new properties will only be returned if the /2.1/ version of a method is called.
- Limited support for writing via the API, restricted to comments.
- /users/{ids}/top-answer-tags and users/{ids}/top-question-tags are now vectorized.
write_access
andprivate_info
scopes added to OAuth flows.
New Methods
- /comments/{id}/delete
- /comments/{id}/edit
- /me/merges
- /me/notifications
- /me/notifications/unread
- /me/reputation-history
- /me/reputation-history/full
- /me/write-permissions
- /notifications
- /notifications/unread
- /posts/{id}/comments/add
- /search/advanced
- /users/{ids}/merges
- /users/{ids}/reputation-history
- /users/{ids}/reputation-history/full
- /users/{ids}/write-permissions
- /users/{id}/notifications
- /users/{id}/notifications/unread
New Types
Additions To Existing Types
- answer.tags
- comment.body_markdown
- site.high_resolution_icon_url
- post.link
- question.close_vote_count
- question.reopen_vote_count
- question.delete_vote_count
- question.notice
- top_tag.user_id
Version 2.0
General Changes
- All API request now go to
api.stackexchange.com
with asite
parameter, rather than per-site endpoints as in V1.x. - All methods found on Stack Auth in V1.x are now found under
api.stackexchange.com
, but do not require asite
parameter. - All method now return a common response wrapper object, which places data in the
items
property. - Throttle and request quota information is now returned as part of the reponse body, not in headers as in V1.x.
- DEFLATE is available as a response compression option, joining GZIP from V1.x.
callback
is now available for JSONP in addition tojsonp
from V1.x.- All returned fields are now safe to inline in HTML by default, further discussion under the safety topic.
Method Changes
- /badges/{ids} now returns badges.
- /badges/{ids}/recipients replaces the old
/badges/{ids}
- /questions/{ids}/comments and /answers/{ids}/comments no longer work for the incorrect post type.
- /revisions/{ids} now takes revision.revision_guid instead of post ids, /posts/{ids}/revisions replaces the V1.x method.
- /users now returns unregistered users in addition to registered users and moderators.
- /info has replaced the
/stats
method from V1.x. - The featured sort is no longer available on /questions, the new /questions/featured method should be used instead.
- /users/{id}/associated now expects account ids to be passed, not association guids. Assocation guids are deprecated.
General Additions
- It is now possible to authenticate Stack Exchange users via OAuth 2.0.
- Filters make it possible to optimize both the response size and request time of queries to the API.
- In conjunction with authentication, a series of per-user throttles are now available in addtion to the per-IP ones from V1.x.
- Every method of the form
/users/{ids}*
now has a/me
version, which is the same as calling the/users/{ids}
version with the user id of the passedaccess_token
passed.
New Methods
- /badges/recipients
- /badges/{ids}/recipients
- /errors
- /events
- /posts
- /posts/{ids}
- /posts/{ids}/revisions
- /posts/{ids}/suggested-edits
- /suggested-edits
- /suggested-edits/{ids}
- /info
- /questions/featured
- /tags/required
- /tags/moderator-only
- /tags/{tags}/info
- /tags/{tags}/faq
- /tags/{tags}/related
- /users/{ids}/suggested-edits
- /users/moderators/elected
- /users/{id}/inbox
- /users/{id}/inbox/unread
- /access-tokens/{accessTokens}/invalidate
- /access-tokens/{accessTokens}
- /apps/{accessTokens}/de-authenticate
- /filters/create
- /filters/{filters}
- /inbox
- /inbox/unread