Skip to main content
POST
Listen Sie zugängliche Projekte mit Seitennavigation, Namenssuche sowie Sprach- und Statusfiltern auf. Ein Teamgast sieht nur die API-Projekte, die er selbst erstellt hat.

​
Authentifizierung und Berechtigungen

​
string
erforderlich
Senden Sie einen VoiceCheap-API-Schlüssel in diesem Header. Authorization: Bearer mit demselben API-Schlüssel wird ebenfalls unterstützt. OAuth-Zugriffstoken werden nur von MCP akzeptiert, nicht von diesem REST-Endpunkt.
Erforderliche Berechtigungen: projects:read. Ein aktives kostenpflichtiges Abonnement ist erforderlich. Berechtigungen ändern weder Teamrollen noch Ressourceneigentum, Medienguthaben oder Tariflimits.

​
Parameter

​
string
Textwert.Mindestlänge: 1. Höchstlänge: 200.
​
integer
Ganzzahliger Wert.Minimum: 0. Maximum: 100000. Standardwert: 0.
​
integer
Ganzzahliger Wert.Minimum: 1. Maximum: 50. Standardwert: 20.
​
string
Textwert.Zulässige Werte: “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
Textwert.Zulässige Werte: “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
Textwert.Zulässige Werte: “awaitingProofreading”, “translated”, “failed”.
​
string
Textwert.Zulässige Werte: “newestFirst”, “oldestFirst”. Standardwert: “newestFirst”.
​
string
Textwert.Mindestlänge: 1. Höchstlänge: 200. Muster: ^[^/\\]+$.
Das folgende JSON Schema enthält die exakten Feldnamen, verschachtelten Typen, Standardwerte, Grenzen und akzeptierten Werte aus der Discovery. Zusätzliche feldübergreifende Regeln finden Sie in den Hinweisen zur Operation.

​
Anfragebeispiele

Ersetzen Sie die beispielhaften Ressourcenkennungen und Medienschlüssel durch Werte, die für Ihr Konto zurückgegeben wurden. Behalten Sie bei Wiederholungen derselben Mutation dieselbe Anfragekennung bei.

​
Antwort

Eine erfolgreiche erste Ausführung gibt HTTP 200 mit dem Ergebnis der Operation unter data zurück. Bei einer Wiederholung kann stattdessen der gespeicherte Anfragestatus zurückgegeben werden. Das Beispiel zeigt eine unterstützte Antwort, nicht alle optionalen Felder. Gibt eine Seite mit zugänglichen Projektzusammenfassungen und Metadaten zur Offset-Paginierung zurück.

​
Ergebnisfelder

​
Hinweise zur Operation

  • offset ist standardmäßig 0, limit 20 (maximal 50) und sort newestFirst. query sucht nach dem Projektnamen; folderId, Ausgangssprache, Zielsprache und status filtern die Liste.
  • Die zurückgegebenen Projektfelder sind projectId, projectName, originalLanguage, targetLanguages, duration, createdAt, progressStep und folderId. Optionale nicht gespeicherte Felder können fehlen; targetLanguages ist standardmäßig [], duration ist 0 und folderId ist null.
  • nextOffset wird gesetzt, wenn die zugrunde liegende abgerufene Seite limit Einträge enthält; es ist weder eine Gesamtanzahl noch ein Nachweis dafür, dass ein weiteres zugängliches Ergebnis existiert.
  • Teamgäste sehen nur Projekte, die dasselbe Mitglied im selben Team über die API erstellt hat. Die Filterung kann ein kürzeres projects-Array ergeben, selbst wenn nextOffset vorhanden ist.
  • originalLanguage verwendet Ausgangssprachcodes wie fr oder en (oder auto-detect, sofern akzeptiert); targetLanguage verwendet unterstützte Zielsprachnamen wie english.

​
Nutzung

Jeder erfolgreiche Aufruf verbraucht einen monatlichen API/MCP-Aufruf. Zusätzlich gelten das Medienguthaben und die eigenen Generierungskontingente der Operation.

​
Fehler