Skip to main content
POST
Pobierz szczegóły projektu, ustawienia dostępne do edycji, rewizję segmentów, adresy URL wyników i wersje tłumaczenia.

Uwierzytelnianie i uprawnienia

string
wymagane
Wyślij klucz API VoiceCheap w tym nagłówku. Obsługiwany jest również nagłówek Authorization: Bearer z tym samym kluczem API. Tokeny dostępu OAuth są akceptowane tylko przez MCP, a nie przez ten endpoint REST.
Wymagane uprawnienia: projects:read. Wymagana jest aktywna płatna subskrypcja. Uprawnienia nie zmieniają ról w zespole, własności zasobów, kredytów na multimedia ani limitów planu.

Parametry

string
wymagane
Wartość tekstowa.Minimalna długość: 1. Maksymalna długość: 200. Wzorzec: ^[^/\\]+$.
Poniższy JSON Schema zachowuje dokładne nazwy pól, typy zagnieżdżone, wartości domyślne, ograniczenia i akceptowane wartości udostępniane przez mechanizm wykrywania. Dodatkowe reguły zależności między polami znajdują się w uwagach do operacji.

Przykłady żądań

Zastąp przykładowe identyfikatory zasobów i klucze multimediów wartościami zwróconymi dla Twojego konta. Przy ponawianiu tej samej operacji zmieniającej dane zachowaj identyfikator żądania.

Odpowiedź

Pierwsze pomyślne wykonanie zwraca HTTP 200 z wynikiem operacji w data. Ponowienie może zamiast tego zwrócić zapisany stan żądania. Przykład przedstawia jedną obsługiwaną odpowiedź, bez wszystkich opcjonalnych pól. Zwraca publiczne szczegóły projektu, ustawienia klienta, bieżącą rewizję struktury źródłowej i każdą przetłumaczoną wersję wynikową.

Pola wyniku

Uwagi do operacji

  • Ta akcja nie zwraca tekstu transkrypcji ani surowych dokumentów segmentów. Użyj transcripts_get, aby pobrać treść transkrypcji, oraz translations_list, aby pobrać metadane wersji językowych.
  • Brakujące opcjonalne pola zagnieżdżone są pomijane w serializowanym JSON. Adresy URL wyników są pustymi ciągami znaków, dopóki odpowiedni wynik nie będzie dostępny.
  • Stan projektu podsumowuje proces i najnowszą przetłumaczoną wersję; przy zarządzaniu kilkoma językami sprawdzaj poszczególne wpisy translations[].
  • Pole error opisuje zapisany błąd przetwarzania; udane pobranie projektu zakończonego błędem nadal zwraca zwykły wynik.
  • Zapisane błędy zwracają kody błędów VoiceCheap i stałe komunikaty. Użyj kodu i aktualnego stanu zasobu, aby zdecydować, jak wznowić działanie.

Wykorzystanie

Każde pomyślne wywołanie zużywa jedno wywołanie z miesięcznego limitu API/MCP. Obowiązują również kredyty na multimedia oraz limity generowania danej operacji.

Błędy