Skip to main content
POST
Wyświetl miniatury połączonego konta, od najnowszych, w tym podglądy przypisane z narzędzia publicznego. Zawiera stan, wymiary i termin wygaśnięcia; użyj nextCursor, aby pobrać następną stronę.

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: thumbnails: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

integer
Liczba całkowita.Minimum: 1. Maksimum: 100. Wartość domyślna: 20.
string
nextCursor z poprzedniej strony.Minimalna długość: 1. Maksymalna długość: 512.
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. Strona metadanych miniatur należących do połączonego użytkownika, od najnowszych. Obejmuje również miniatury z narzędzia publicznego wcześniej przypisane do tego konta.

Pola wyniku

Uwagi do operacji

  • Wymaga thumbnails:read. limit ma domyślną wartość 20 i musi być liczbą całkowitą od 1 do 100. cursor jest opcjonalny i ma ograniczenie do 512 znaków.
  • Przekaż nextCursor bez zmian jako cursor dla następnej strony. Na końcu nextCursor ma wartość null; sortowanie odbywa się malejąco według czasu utworzenia i identyfikatora generowania.
  • Ta akcja korzysta z własnych utworzonych materiałów i przesłanych plików połączonego użytkownika, również gdy dane uwierzytelniające są połączone w kontekście zespołu.
  • Metadane miniatur wskazują completed, expired lub deleted. Ta historia nie udostępnia rekordu oczekującego generowania; sprawdzaj action_request_get, aby śledzić żądanie generowania miniatury.
  • Korzystaj z expiresAt każdego rekordu, również w przypadku przypisanych do konta wyników narzędzi publicznych. Widocznego rekordu, który wygasł lub został usunięty, nie można pobrać. Pusta historia zwraca items: [] i nextCursor: null.
  • Użyj thumbnails_download, aby pobrać dane WebP; ta historia nie zawiera osadzonych obrazów ani adresów URL podglądu.

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