Skip to main content
POST
Pobierz postęp publikacji oryginału, próby publikacji tłumaczeń i zaplanowane publikacje dla dostępnego projektu.

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: publishing: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 stan publikacji oryginału projektu, publiczne próby publikacji tłumaczeń i zaplanowane przez użytkownika publikacje tego projektu.

Pola wyniku

Uwagi do operacji

  • originalPublish ma wartość null, gdy projekt nie ma stanu publikacji oryginału. Jego projekcja wyklucza zapisane rozliczenia kredytów, uwierzytelnianie kanału, konfigurację prywatności i surowe komunikaty błędów.
  • Każdy wpis translations ma tablice attempts i publishedVideos, w tym [] przy braku rekordów.
  • scheduled jest filtrowane zarówno według projectId, jak i uwierzytelnionego podmiotu wykonującego akcję, a nie według faktycznego właściciela rozliczeń zespołu.
  • To akcja sprawdzania stanu zasobu po zakończeniu wykonania żądania akcji publikacji.
  • 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