Skip to main content
POST
페이지 구분, 이름 검색, 언어 및 상태 필터를 사용하여 접근 가능한 프로젝트 목록을 조회합니다. 팀 게스트는 본인이 생성한 API 프로젝트만 볼 수 있습니다.

​
인증 및 권한

​
string
필수
이 헤더에 VoiceCheap API 키를 전달하세요. 동일한 API 키를 사용하는 Authorization: Bearer도 지원합니다. OAuth 액세스 토큰은 MCP에서만 허용되며, 이 REST 엔드포인트에서는 사용할 수 없습니다.
필요한 권한: projects:read. 활성 유료 구독이 필요합니다. 권한은 팀 역할, 리소스 소유권, 미디어 크레딧 또는 요금제 한도를 변경하지 않습니다.

​
매개변수

​
string
텍스트 값입니다.최소 길이: 1. 최대 길이: 200.
​
integer
정수 값입니다.최솟값: 0. 최댓값: 100000. 기본값: 0.
​
integer
정수 값입니다.최솟값: 1. 최댓값: 50. 기본값: 20.
​
string
텍스트 값입니다.허용값: “afrikaans”, “albanian”, “amharic”, “arabic”, “armenian”, “assamese”, “azerbaijani”, “basque”, “belarusian”, “bengali”, “bosnian”, “bulgarian”, “catalan”, “croatian”, “czech”, “danish”, “dutch”, “english”, “british english”, “estonian”, “finnish”, “french”, “french canadian”, “galician”, “german”, “greek”, “gujarati”, “hebrew”, “hindi”, “hungarian”, “icelandic”, “indonesian”, “irish”, “italian”, “japanese”, “kannada”, “kazakh”, “khmer”, “korean”, “lao”, “latvian”, “lithuanian”, “macedonian”, “malay”, “malayalam”, “mandarin”, “marathi”, “mongolian”, “nepali”, “norwegian”, “persian”, “polish”, “portuguese”, “brazilian portuguese”, “pt_brazil”, “punjabi”, “romanian”, “russian”, “serbian”, “slovak”, “slovenian”, “spanish”, “swahili”, “swedish”, “tagalog”, “tamil”, “telugu”, “thai”, “turkish”, “ukrainian”, “urdu”, “vietnamese”, “welsh”, “yoruba”, “zulu”.
​
string
텍스트 값입니다.허용값: “af”, “sq”, “am”, “ar”, “hy”, “as”, “ast”, “az”, “ba”, “eu”, “be”, “bn”, “bs”, “br”, “bg”, “my”, “ca”, “ceb”, “zh”, “hr”, “cs”, “da”, “nl”, “en”, “eo”, “at”, “et”, “fil”, “fo”, “fi”, “fr”, “fr-CA”, “fy”, “ff”, “gd”, “gl”, “lg”, “ka”, “de”, “el”, “gu”, “ht”, “ha”, “haw”, “he”, “hi”, “hu”, “is”, “ig”, “ilo”, “id”, “ia”, “ga”, “it”, “ja”, “jv”, “kea”, “kn”, “kk”, “km”, “kur”, “kir”, “ko”, “lo”, “la”, “luo”, “lv”, “lb”, “ln”, “lt”, “mk”, “mg”, “ms”, “ml”, “mt”, “mi”, “mr”, “mo”, “mn”, “ne”, “no”, “nn”, “nso”, “nya”, “oc”, “or”, “pa”, “ps”, “fa”, “pl”, “pt”, “ro”, “ru”, “sa”, “sr”, “sn”, “sd”, “si”, “sk”, “sl”, “so”, “es”, “su”, “sw”, “ss”, “sv”, “tl”, “tg”, “ta”, “tt”, “te”, “th”, “bo”, “tn”, “tr”, “tk”, “ug”, “uk”, “umb”, “ur”, “uz”, “vi”, “cy”, “wo”, “xh”, “yi”, “yo”, “zu”, “cmn”, “yue”, “en-GB”, “en-US”, “en-AU”, “auto-detect”.
​
string
텍스트 값입니다.허용값: “awaitingProofreading”, “translated”, “failed”.
​
string
텍스트 값입니다.허용값: “newestFirst”, “oldestFirst”. 기본값: “newestFirst”.
​
string
텍스트 값입니다.최소 길이: 1. 최대 길이: 200. 패턴: ^[^/\\]+$.
아래 JSON Schema는 검색을 통해 제공되는 정확한 필드 이름, 중첩 유형, 기본값, 범위 및 허용값을 유지합니다. 추가적인 필드 간 규칙은 작업 참고 사항에 나와 있습니다.

​
요청 예제

예제의 리소스 식별자와 미디어 키를 계정에서 반환된 값으로 바꾸세요. 동일한 변경 작업을 재시도할 때는 요청 식별자를 유지하세요.

​
응답

성공한 첫 실행은 작업 결과를 data 아래에 포함하여 HTTP 200을 반환합니다. 재전송 시에는 저장된 요청 상태를 대신 반환할 수 있습니다. 예제는 지원되는 응답 중 하나를 보여주며 모든 선택 필드를 포함하지는 않습니다. 접근 가능한 프로젝트 요약 한 페이지와 오프셋 페이지 나누기 메타데이터를 반환합니다.

​
결과 필드

​
작업 참고 사항

  • offset의 기본값은 0, limit는 20(최대 50), sort는 newestFirst입니다. query는 프로젝트 이름으로 검색하며 folderId, 원본 언어, 대상 언어 및 상태는 목록을 필터링합니다.
  • 반환되는 프로젝트 필드는 projectId, projectName, originalLanguage, targetLanguages, duration, createdAt, progressStep 및 folderId입니다. 저장되지 않은 선택적 필드는 생략될 수 있습니다. targetLanguages의 기본값은 [], duration은 0, folderId는 null입니다.
  • 실제로 가져온 페이지에 limit개의 항목이 있으면 nextOffset이 설정됩니다. 이는 총 개수가 아니며 접근 가능한 다른 결과가 있다는 증거도 아닙니다.
  • 팀 게스트는 같은 팀에서 해당 멤버가 API를 통해 생성한 프로젝트만 볼 수 있습니다. 필터링으로 인해 nextOffset이 있어도 projects 배열이 더 짧아질 수 있습니다.
  • originalLanguage는 fr 또는 en과 같은 원본 언어 코드(허용되는 경우 auto-detect)를 사용하고, targetLanguage는 english와 같은 지원 대상 언어 이름을 사용합니다.

​
사용량

성공한 호출마다 월간 API/MCP 호출 1회가 차감됩니다. 미디어 크레딧과 해당 작업의 생성 허용량도 적용됩니다.

​
오류