> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 액션 OpenAPI 문서 가져오기

> 모든 고객 액션과 해당 입력 스키마에 대한 공개 OpenAPI 3.1 설명을 읽습니다.

모든 고객 액션과 해당 입력 스키마에 대한 공개 OpenAPI 3.1 설명을 읽습니다.

```http theme={null}
GET https://api.voicecheap.ai/v1/openapi.json
```

## 인증

없습니다. 이 경로는 계정을 인증하거나 액션에 대한 접근 권한을 부여하지 않습니다.

## 요청 예제

이 경로에 명시된 인코딩 및 인증 방식을 따르세요. 액션 API의 응답 구조와 멱등성 규칙은 액션 호출에만 적용됩니다.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET 'https://api.voicecheap.ai/v1/openapi.json'
  ```

  ```javascript JavaScript theme={null}
  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());
  ```

  ```python Python theme={null}
  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)
  ```
</RequestExample>

## 응답

대표적인 메타데이터 발췌 예시입니다. 전체 응답에는 등록된 모든 액션의 경로도 포함되며, 각 액션의 JSON 요청 스키마, 필수 범위, 변경 작업 멱등성 헤더 및 문서화된 HTTP 결과가 포함됩니다.

```json HTTP 200 theme={null}
{
  "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"
      }
    }
  }
}
```

## 작업 참고 사항

* 반환된 servers\[0].url에는 /v1이 포함됩니다. 문서의 액션 경로는 /actions/로 시작하므로 /v1을 다시 추가하지 마세요.
* 필터링되지 않은 전체 액션 카탈로그입니다. 특정 자격 증명으로 사용할 수 있는 액션을 확인하려면 인증된 GET /v1/actions를 사용하세요.
* 런타임 OpenAPI 문서는 액션 디스패치만 다룹니다. OAuth 경로, /mcp, 검색 자체 또는 기존 멀티파트 경로는 포함하지 않습니다.
* 이 읽기는 월간 통합 호출이나 계정 통합 요청률 카운터를 소모하지 않습니다. 서비스의 공개 HTTP 보호 기능은 계속 적용됩니다.
* 예시는 프로덕션 오리진을 사용합니다. 프로덕션과 개발 환경을 혼용하지 말고 선택한 환경의 메타데이터를 조회하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.