POST oauth/invalidate_token

让注册的应用程序可以通过提供其客户端凭据来撤销已颁发的 OAuth access_token。access_token 失效后,尝试新的创建操作将生成一个不同的访问令牌,无效的令牌将无法再使用。

资源 URL

https://api.twitter.com/1.1/oauth/invalidate_token

资源信息

响应格式 JSON
是否需要身份验证? 是 - 具有希望失效的访问令牌的用户上下文
是否存在速率限制?

示例请求

    curl --request POST 
      --url 'https://api.twitter.com/1.1/oauth/invalidate_token.json' 
      --header 'authorization: OAuth oauth_consumer_key="CLIENT_KEY",
     oauth_nonce="AUTO_GENERATED_NONCE", oauth_signature="AUTO_GENERATED_SIGNATURE",
     oauth_signature_method="HMAC-SHA1", oauth_timestamp="AUTO_GENERATED_TIMESTAMP",
     oauth_token="ACCESS_TOKEN", oauth_version="1.0"'

响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json; charset=utf-8
    Content-Length: 127
    ...

    {"access_token":"ACCESS_TOKEN"}

令牌失效后的错误响应示例

    HTTP/1.1 401 Authorization Required
    ...

    {"errors": [{
      "code": 89,
      "message": "Invalid or expired token."}
    ]}