Révoquer une connexion OAuth MCP

POST https://api.voicecheap.ai/oauth/revoke

​

Authentification

​

Corps de la requête

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
      "description": "An issued MCP access or refresh token. Unknown token strings are accepted without revealing whether a token exists."
    },
    "client_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^[^\\u0000-\\u001F\\u007F]+$",
      "description": "The client_id associated with the token. A missing or malformed scalar is rejected; an unknown or mismatched client returns success."
    },
    "token_type_hint": {
      "description": "Optional standard hint. This implementation ignores this field and does not validate its value; token prefixes determine the token family."
    }
  },
  "required": [
    "token",
    "client_id"
  ],
  "additionalProperties": true
}

​

Exemples de requêtes

curl --request POST 'https://api.voicecheap.ai/oauth/revoke' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'token=mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE' \
  --data-urlencode 'client_id=mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA' \
  --data-urlencode 'token_type_hint=refresh_token'

const input = {
  token: 'mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE',
  client_id: 'mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
  token_type_hint: 'refresh_token',
};
const response = await fetch('https://api.voicecheap.ai/oauth/revoke', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
  },
  body: new URLSearchParams(input),
  redirect: 'manual',
});
console.log(response.status, await response.text());

import os
import requests

response = requests.request(
    "POST",
    "https://api.voicecheap.ai/oauth/revoke",
    headers={"Content-Type":"application/x-www-form-urlencoded"},
    data={"token": "mcp_refresh_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE", "client_id": "mcp_client_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "token_type_hint": "refresh_token"},
    timeout=120,
    allow_redirects=False,
)
print(response.status_code, response.text)

​

Réponse

{}

​

En-têtes de réponse

{
  "Cache-Control": "no-store",
  "Pragma": "no-cache"
}

​

Notes de l’opération

• Les paramètres scalaires reconnus doivent être fournis une seule fois, sous forme de chaînes non vides sans caractères de contrôle ASCII ni DEL. Les champs de requête ou de formulaire répétés sont décodés en tableaux et rejetés lorsqu’ils sont lus comme des scalaires.
• Utilisez application/x-www-form-urlencoded. Les requêtes JSON sont rejetées avec invalid_request.
• La révocation d’un jeton d’accès ou d’actualisation reconnu révoque la connexion entière et efface son jeton d’actualisation actif ; elle ne se limite pas au seul jeton fourni.
• Le paramètre resource n’est ni obligatoire ni vérifié sur cette route. token_type_hint et les autres champs non reconnus sont ignorés.
• Le point de terminaison ne récupère pas d’abord l’enregistrement du client. Un client_id inconnu mais bien formé, un client_id incorrect pour le jeton ou un jeton inconnu renvoie {} sans révéler la validité du jeton.
• La limite publique de révocation est de 60 requêtes par minute par adresse IP cliente, partagée entre les workers. Les corps encodés au format URL sont limités à 32 KiB.
• Le client_id renvoyé par l’enregistrement dynamique ou l’URL HTTPS publique exacte du document de métadonnées du client.

​

Erreurs