> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Verbonden publicatiekanalen weergeven

> Geef de identiteiten van je eigen verbonden YouTube- en TikTok-kanalen weer. Authenticatietokens worden nooit geretourneerd.

Geef de identiteiten van je eigen verbonden YouTube- en TikTok-kanalen weer. Authenticatietokens worden nooit geretourneerd.

```http theme={null}
POST https://api.voicecheap.ai/v1/actions/publishing_channels_list
```

## Authenticatie en machtigingen

<ParamField header="x-api-key" type="string" required>
  Stuur een VoiceCheap API-sleutel mee in deze header. Authorization: Bearer met dezelfde API-sleutel wordt ook ondersteund. OAuth-toegangstokens
  worden alleen door MCP geaccepteerd, niet door dit REST-endpoint.
</ParamField>

Vereiste machtigingen: `publishing:read`.

Een actief betaald abonnement is vereist. Machtigingen wijzigen geen teamrollen, eigendom van resources, mediategoed of abonnementslimieten.

## Parameters

Stuur een leeg JSON-object. Deze actie heeft geen invoervelden.

<Accordion title="Volledig invoerschema">
  Het onderstaande JSON Schema behoudt de exacte veldnamen, geneste typen, standaardwaarden, grenzen en toegestane waarden die discovery beschikbaar stelt. Aanvullende regels tussen velden staan in de opmerkingen bij de bewerking.

  ```json theme={null}
  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
  ```
</Accordion>

## Voorbeeldaanvragen

Vervang de voorbeeldidentificaties van resources en mediasleutels door waarden die voor je account zijn geretourneerd. Behoud dezelfde aanvraagidentificatie wanneer je dezelfde wijziging opnieuw probeert.

<RequestExample>
  ```bash cURL theme={null}
  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 '{}'
  ```

  ```javascript JavaScript theme={null}
  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);
  ```

  ```python Python theme={null}
  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)
  ```
</RequestExample>

## Antwoord

Een geslaagde eerste uitvoering retourneert HTTP 200 met het resultaat van de bewerking onder data. Een herhaalde aanvraag kan in plaats daarvan de opgeslagen aanvraagstatus retourneren. Het voorbeeld toont één ondersteund antwoord, niet alle optionele velden.

Retourneert openbare identiteiten van de verbonden YouTube- en TikTok-kanalen van de geauthenticeerde uitvoerende gebruiker.

<ResponseExample>
  ```json HTTP 200 theme={null}
  {
    "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"
          ]
        }
      ]
    }
  }
  ```
</ResponseExample>

## Resultaatvelden

| Veld | Beschrijving |
| - | - |
| `data.channels` | Identiteiten van gekoppelde kanalen op beide platforms. |
| `data.channels[].platform` | youtube of tiktok. |
| `data.channels[].channelId` | Gebruik in channel-arrays van publishing\_original\_create of in publishing\_translation\_create.channelId. |
| `data.channels[].name` | Weergavenaam van het gekoppelde kanaal. |
| `data.channels[].profilePicture` | Optionele URL van de profielafbeelding. |
| `data.channels[].associatedLanguage` | Optionele kanaaltaal. |
| `data.channels[].isMainChannel` | Optionele vlag voor het hoofdkanaal. |
| `data.channels[].canPost` | Optionele mogelijkheid om op TikTok te publiceren. |
| `data.channels[].privacyLevelOptions` | Optionele TikTok-privacyniveaus die door het verbonden account worden ondersteund. |

## Opmerkingen bij de bewerking

* Dit toont de eigen kanalen van de uitvoerende gebruiker, ook wanneer de projectfacturering bij een teameigenaar hoort. Het retourneert geen toegangstokens of vernieuwingstokens van kanalen.
* Beide platforms stellen platform, channelId, name en optioneel profilePicture, associatedLanguage en isMainChannel beschikbaar. TikTok kan daarnaast canPost en privacyLevelOptions beschikbaar stellen.
* De actie toont alleen bestaande verbindingen; deze koppelt geen nieuw sociaal account.

## Verbruik

Elke geslaagde aanroep verbruikt één maandelijkse API/MCP-aanroep. Ook het mediategoed en de eigen generatielimieten van de bewerking zijn van toepassing.

## Fouten

| HTTP-status | Code | Betekenis of herstel |
| - | - | - |
| 400 | `CREDENTIAL_IN_QUERY` | Inloggegevens zijn opgegeven in een queryparameter access\_token of api\_key. Stuur inloggegevens in headers. |
| 400 | `VALIDATION_ERROR` | Corrigeer de invoer aan de hand van het schema. Ongeldige of tegenstrijdige waarden worden vóór de uitvoering geweigerd. |
| 401 | `API_KEY_EXPIRED` | De API-sleutel is verlopen. |
| 401 | `INVALID_API_KEY` | Geef een geldige, niet-verlopen API-sleutel op. |
| 401 | `INVALID_CREDENTIAL` | De Authorization-header heeft een ongeldige indeling of is in strijd met x-api-key. |
| 401 | `MISSING_CREDENTIAL` | Er is geen bruikbaar authenticatiemiddel in de header opgegeven, of het overschreed 4096 tekens. |
| 401 | `USER_NOT_FOUND` | Het account dat bij de toegangsgegevens hoort, bestaat niet meer. |
| 403 | `AMBIGUOUS_TEAM_API_KEY` | De gebruiker van het authenticatiemiddel behoort tot meer dan één team, waardoor de factureringscontext onduidelijk is. |
| 403 | `INSUFFICIENT_SCOPE` | Verleen alle vereiste machtigingen of kies andere toegangsgegevens. |
| 403 | `INTEGRATION_PLAN_UNSUPPORTED` | De integratielimieten van het account konden niet worden geverifieerd. |
| 403 | `SUBSCRIPTION_REQUIRED` | Gebruik een actief betaald abonnement. |
| 403 | `TEAM_OWNER_NOT_FOUND` | Het effectieve account van de teameigenaar kon niet worden gevonden. |
| 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Wacht tot de maandelijkse reset of wijzig je abonnement. |
| 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Wacht de tijd uit Retry-After af wanneer deze aanwezig is en vergroot de wachttijd tussen nieuwe pogingen. |
| 500 | `INTERNAL_ERROR` | Controleer de opgeslagen aanvraagstatus en de resourcegeschiedenis voordat je besluit een wijziging opnieuw te proberen. |
| 503 | `SERVER_RESTARTING` | De server wordt opnieuw gestart. Probeer het zo opnieuw en behoud bij een wijziging dezelfde aanvraagidentificatie. |

```json theme={null}
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "This credential does not permit the requested action.",
  "status": 403,
  "details": {
    "requiredScopes": ["publishing:read"]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.