Ottieni il documento OpenAPI delle azioni

GET https://api.voicecheap.ai/v1/openapi.json

​

Autenticazione

​

Esempi di richiesta

curl --request GET 'https://api.voicecheap.ai/v1/openapi.json'

const input = {};
const response = await fetch('https://api.voicecheap.ai/v1/openapi.json', {
  method: 'GET',
  headers: {},
  redirect: 'manual',
});
console.log(response.status, await response.text());

import os
import requests

response = requests.request(
    "GET",
    "https://api.voicecheap.ai/v1/openapi.json",
    headers={},
    timeout=120,
    allow_redirects=False,
)
print(response.status_code, response.text)

​

Risposta

{
  "openapi": "3.1.0",
  "info": {
    "title": "VoiceCheap API",
    "version": "1.0.0",
    "description": "Public customer actions shared with the VoiceCheap MCP. Existing multipart v1 routes remain documented separately."
  },
  "servers": [
    {
      "url": "https://api.voicecheap.ai/v1"
    }
  ],
  "security": [
    {
      "ApiKey": []
    },
    {
      "BearerApiKey": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      },
      "BearerApiKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "VoiceCheap API key"
      }
    }
  }
}

​

Note sull’operazione

• Il servers[0].url restituito include /v1. I percorsi delle azioni nel documento iniziano con /actions/, quindi non aggiungere /v1 una seconda volta.
• Questo è il catalogo completo delle azioni, senza filtri. Usa GET /v1/actions con autenticazione per scoprire quali azioni una specifica credenziale è autorizzata a usare.
• Il documento OpenAPI disponibile a runtime copre solo l’inoltro delle azioni; non include le route OAuth, /mcp, l’individuazione stessa o le route multipart esistenti.
• Questa lettura non consuma una chiamata di integrazione mensile né incrementa il contatore della frequenza di integrazione dell’account. Restano applicabili le protezioni HTTP pubbliche del servizio.
• Gli esempi usano origini di produzione. Leggi i metadati dell’ambiente selezionato anziché mescolare produzione e sviluppo.