curl --request POST 'https://api.voicecheap.ai/v1/actions/publishing_channels_list' \
--header "x-api-key: $VOICECHEAP_API_KEY" \
--header 'Content-Type: application/json' \
--data '{}'
const input = {};
const response = await fetch('https://api.voicecheap.ai/v1/actions/publishing_channels_list', {
method: 'POST',
headers: {
'x-api-key': process.env.VOICECHEAP_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);
import os
import requests
response = requests.post(
"https://api.voicecheap.ai/v1/actions/publishing_channels_list",
headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
json={},
timeout=120,
)
body = response.json()
if not response.ok:
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)
{
"data": {
"channels": [
{
"platform": "youtube",
"channelId": "UC1234567890abcdefghijkl",
"name": "Product updates",
"profilePicture": "https://media.example.com/channels/profile.jpg",
"associatedLanguage": "english",
"isMainChannel": true
},
{
"platform": "tiktok",
"channelId": "tiktok_product_updates",
"name": "Product updates",
"associatedLanguage": "english",
"isMainChannel": false,
"canPost": true,
"privacyLevelOptions": [
"SELF_ONLY",
"PUBLIC_TO_EVERYONE"
]
}
]
}
}
Publikowanie
Wyświetl połączone kanały publikacji
Wyświetl dane własnych połączonych kanałów YouTube i TikTok. Tokeny uwierzytelniania nigdy nie są zwracane.
POST
/
v1
/
actions
/
publishing_channels_list
curl --request POST 'https://api.voicecheap.ai/v1/actions/publishing_channels_list' \
--header "x-api-key: $VOICECHEAP_API_KEY" \
--header 'Content-Type: application/json' \
--data '{}'
const input = {};
const response = await fetch('https://api.voicecheap.ai/v1/actions/publishing_channels_list', {
method: 'POST',
headers: {
'x-api-key': process.env.VOICECHEAP_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);
import os
import requests
response = requests.post(
"https://api.voicecheap.ai/v1/actions/publishing_channels_list",
headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
json={},
timeout=120,
)
body = response.json()
if not response.ok:
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)
{
"data": {
"channels": [
{
"platform": "youtube",
"channelId": "UC1234567890abcdefghijkl",
"name": "Product updates",
"profilePicture": "https://media.example.com/channels/profile.jpg",
"associatedLanguage": "english",
"isMainChannel": true
},
{
"platform": "tiktok",
"channelId": "tiktok_product_updates",
"name": "Product updates",
"associatedLanguage": "english",
"isMainChannel": false,
"canPost": true,
"privacyLevelOptions": [
"SELF_ONLY",
"PUBLIC_TO_EVERYONE"
]
}
]
}
}
Wyświetl dane własnych połączonych kanałów YouTube i TikTok. Tokeny uwierzytelniania nigdy nie są zwracane.
Wymagane uprawnienia:
POST https://api.voicecheap.ai/v1/actions/publishing_channels_list
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.
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
Wyślij pusty obiekt JSON. Ta akcja nie ma pól wejściowych.Pełny schemat danych wejściowych
Pełny schemat danych wejściowych
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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}
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.curl --request POST 'https://api.voicecheap.ai/v1/actions/publishing_channels_list' \
--header "x-api-key: $VOICECHEAP_API_KEY" \
--header 'Content-Type: application/json' \
--data '{}'
const input = {};
const response = await fetch('https://api.voicecheap.ai/v1/actions/publishing_channels_list', {
method: 'POST',
headers: {
'x-api-key': process.env.VOICECHEAP_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify(input),
});
const body = await response.json();
if (!response.ok) throw new Error(body.code + ': ' + body.message);
console.log(body);
import os
import requests
response = requests.post(
"https://api.voicecheap.ai/v1/actions/publishing_channels_list",
headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
json={},
timeout=120,
)
body = response.json()
if not response.ok:
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
print(body)
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 identyfikatory połączonych kanałów YouTube i TikTok uwierzytelnionego podmiotu wykonującego akcję.{
"data": {
"channels": [
{
"platform": "youtube",
"channelId": "UC1234567890abcdefghijkl",
"name": "Product updates",
"profilePicture": "https://media.example.com/channels/profile.jpg",
"associatedLanguage": "english",
"isMainChannel": true
},
{
"platform": "tiktok",
"channelId": "tiktok_product_updates",
"name": "Product updates",
"associatedLanguage": "english",
"isMainChannel": false,
"canPost": true,
"privacyLevelOptions": [
"SELF_ONLY",
"PUBLIC_TO_EVERYONE"
]
}
]
}
}
Pola wyniku
| Pole | Opis |
|---|---|
data.channels | Tożsamości połączonych kanałów na obu platformach. |
data.channels[].platform | youtube lub tiktok. |
data.channels[].channelId | Używaj w tablicach kanałów publishing_original_create lub w publishing_translation_create.channelId. |
data.channels[].name | Nazwa wyświetlana połączonego kanału. |
data.channels[].profilePicture | Opcjonalny adres URL obrazu profilowego. |
data.channels[].associatedLanguage | Opcjonalny język kanału. |
data.channels[].isMainChannel | Opcjonalna flaga kanału głównego. |
data.channels[].canPost | Opcjonalna możliwość publikowania na TikTok. |
data.channels[].privacyLevelOptions | Opcjonalne poziomy prywatności TikTok obsługiwane przez połączone konto. |
Uwagi do operacji
- Wyświetla własne kanały użytkownika wykonującego żądanie, nawet gdy projekt jest rozliczany na właściciela zespołu. Nie zwraca tokenów dostępu do kanałów ani tokenów odświeżania.
- Obie platformy udostępniają platform, channelId, name oraz opcjonalnie profilePicture, associatedLanguage i isMainChannel. TikTok może dodatkowo udostępniać canPost i privacyLevelOptions.
- Akcja wyświetla tylko istniejące połączenia; nie łączy nowego konta społecznościowego.
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
| Status HTTP | Kod | Znaczenie lub sposób rozwiązania |
|---|---|---|
| 400 | CREDENTIAL_IN_QUERY | Dane uwierzytelniające zostały podane w parametrze zapytania access_token lub api_key. Wysyłaj dane uwierzytelniające w nagłówkach. |
| 400 | VALIDATION_ERROR | Popraw dane wejściowe zgodnie ze schematem. Nieprawidłowe lub niespójne wartości są odrzucane przed wykonaniem. |
| 401 | API_KEY_EXPIRED | Klucz API wygasł. |
| 401 | INVALID_API_KEY | Podaj prawidłowy, niewygasły klucz API. |
| 401 | INVALID_CREDENTIAL | Nagłówek Authorization ma nieprawidłowy format lub jest sprzeczny z x-api-key. |
| 401 | MISSING_CREDENTIAL | Nie podano użytecznych danych uwierzytelniających w nagłówku lub przekroczyły one 4096 znaków. |
| 401 | USER_NOT_FOUND | Konto powiązane z poświadczeniem już nie istnieje. |
| 403 | AMBIGUOUS_TEAM_API_KEY | Użytkownik, do którego należą dane uwierzytelniające, należy do więcej niż jednego zespołu, więc kontekst rozliczeniowy jest niejednoznaczny. |
| 403 | INSUFFICIENT_SCOPE | Nadaj wszystkie wymagane uprawnienia lub wybierz inne dane uwierzytelniające. |
| 403 | INTEGRATION_PLAN_UNSUPPORTED | Nie udało się zweryfikować limitów integracji konta. |
| 403 | SUBSCRIPTION_REQUIRED | Użyj aktywnej płatnej subskrypcji. |
| 403 | TEAM_OWNER_NOT_FOUND | Nie znaleziono konta faktycznego właściciela zespołu. |
| 429 | INTEGRATION_MONTHLY_LIMIT_REACHED | Poczekaj na odnowienie miesięcznego limitu lub zmień plan. |
| 429 | INTEGRATION_RATE_LIMIT_REACHED | Jeśli występuje nagłówek Retry-After, odczekaj wskazany czas i stosuj rosnące odstępy między ponowieniami. |
| 500 | INTERNAL_ERROR | Sprawdź stan zapisanego żądania i historię zasobu przed podjęciem decyzji o ponowieniu operacji zmieniającej dane. |
| 503 | SERVER_RESTARTING | Serwer jest uruchamiany ponownie. Spróbuj ponownie wkrótce i zachowaj ten sam identyfikator żądania dla operacji zmieniającej dane. |
{
"code": "INSUFFICIENT_SCOPE",
"message": "This credential does not permit the requested action.",
"status": 403,
"details": {
"requiredScopes": ["publishing:read"]
}
}
Czy ta strona była pomocna?

