Skip to main content
POST
Sprawdzaj oczekujące, wykonywane i zakończone akcje edycji lub ponownego generowania segmentów 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: 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 bieżącą rewizję kolejki projektu i publiczne elementy akcji w stanie queued, running oraz w stanach końcowych.

Pola wyniku

Uwagi do operacji

  • Sprawdzaj items[].id odpowiadające jobId zwróconemu przez segments_text_update, segments_timestamps_update lub segments_regenerate. completed, failed i cancelled to stany końcowe.
  • revision to rewizja kolejki, a nie źródłowa segmentStructureRevision wymagana do usuwania lub scalania.
  • Akcja może zwrócić potwierdzenie pomyślnego przyjęcia, a później zakończyć się błędem w kolejce. Sprawdź items[].errorCode; przed podjęciem decyzji o nowej akcji odśwież stan odpowiedniego projektu, transkrypcji i wyników.
  • Ta operacja nie przyjmuje parametrów paginacji. Projekt bez kolejki zwraca projectId, revision 0 i pustą tablicę items.
  • Odpowiedzi kolejki, również przy przesyłaniu, anulowaniu, odpytywaniu i ponawianiu, zawierają tylko metadane działań. Odczytuj treść transkrypcji przez transcripts_get z wymaganym uprawnieniem transcription:read.

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