Skip to main content
POST
Liste as identidades dos seus próprios canais YouTube e TikTok conectados. Tokens de autenticação nunca são retornados.

Autenticação e permissões

string
obrigatório
Envie uma chave de API VoiceCheap neste cabeçalho. Authorization: Bearer com a mesma chave de API também é aceito. Tokens de acesso OAuth são aceitos apenas pelo MCP, não por este endpoint REST.
Permissões necessárias: publishing:read. É necessária uma assinatura paga ativa. As permissões não alteram funções na equipe, propriedade dos recursos, créditos de mídia ou limites do plano.

Parâmetros

Envie um objeto JSON vazio. Esta ação não possui campos de entrada.
O JSON Schema abaixo preserva os nomes exatos dos campos, tipos aninhados, valores padrão, limites e valores aceitos expostos pela descoberta. Regras adicionais entre campos são listadas nas notas da operação.

Exemplos de requisição

Substitua os identificadores de recursos e as chaves de mídia dos exemplos pelos valores retornados para sua conta. Mantenha o identificador da requisição ao tentar novamente a mesma alteração.

Resposta

Uma primeira execução bem-sucedida retorna HTTP 200 com o resultado da operação em data. Uma repetição pode retornar o estado salvo da requisição. O exemplo mostra uma resposta aceita, não todos os campos opcionais. Retorna as identidades públicas dos canais do YouTube e TikTok conectados do autor autenticado da ação.

Campos do resultado

Notas da operação

  • Lista os canais do próprio usuário executor, mesmo quando o faturamento do projeto pertence ao proprietário da equipe. Não retorna tokens de acesso nem de atualização dos canais.
  • Ambas as plataformas expõem platform, channelId, name e os opcionais profilePicture, associatedLanguage e isMainChannel. O TikTok também pode expor canPost e privacyLevelOptions.
  • A ação lista apenas conexões existentes; ela não conecta uma nova conta de rede social.

Uso

Cada chamada bem-sucedida consome uma chamada mensal da API/MCP. Os créditos de mídia e as cotas de geração da própria operação também se aplicam.

Erros