Revoca una connessione OAuth MCP

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

​

Autenticazione

​

Corpo della richiesta

{
  "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
}

​

Esempi di richiesta

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)

​

Risposta

{}

​

Intestazioni della risposta

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

​

Note sull’operazione

• I parametri scalari riconosciuti devono essere forniti una sola volta come stringhe non vuote, senza caratteri di controllo ASCII o DEL. I campi ripetuti nella query o nel modulo vengono decodificati come array e rifiutati quando vengono letti come scalari.
• Usa application/x-www-form-urlencoded. Le richieste JSON vengono rifiutate con invalid_request.
• La revoca di un token di accesso riconosciuto o di un refresh token riconosciuto revoca l’intera connessione e cancella il relativo refresh token attivo; non si limita al solo token fornito.
• Il parametro resource non è richiesto né verificato su questa route. token_type_hint e gli altri campi non riconosciuti vengono ignorati.
• L’endpoint non recupera prima la registrazione del client. Un client_id sconosciuto ma formalmente valido, un client_id errato per il token o un token sconosciuto restituiscono {} senza rivelare la validità del token.
• Il limite pubblico di revoca è di 60 richieste al minuto per IP del client, condiviso tra i worker. I corpi con codifica URL sono limitati a 32 KiB.
• Il client_id restituito dalla registrazione dinamica o l’URL HTTPS pubblico esatto del documento di metadati del client.

​

Errori