Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Conexões/Iniciar conexão de rede

Iniciar conexão de rede

GET /v1/connections/:network/start escopo write

Inicia o login OAuth de youtube, tiktok ou meta (Instagram) e devolve o endereço de autorização. Outra conta da mesma rede vira outro canal; a mesma conta é reconectada. Em meta valem replace=true (troca o token de uma conexão existente), add=true (conecta OUTRA conta do Instagram como novo canal), instagram=<usuário>, instagram_id=<id|current> e probe=true (só relata, não grava nada).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/conexoes/:rede/iniciar.

Parâmetros

Nome Onde Descrição
network caminho Rede: youtube, instagram ou tiktok.
replace consulta Só meta: true troca o token de uma conexão existente.
add consulta Só meta: true conecta OUTRA conta como novo canal.
probe consulta Só meta: true só relata, não grava.

Exemplo

curl "https://praeko.app/v1/connections/youtube/start" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=1234567890-abc.apps.googleusercontent.com&redirect_uri=https%3A%2F%2Fpraeko.app%2Fconexoes%2Fyoutube%2Fretorno&response_type=code&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fyoutube.upload+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fyoutube.force-ssl+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fyt-analytics.readonly&code_challenge=D0BtvxL1QkepqaFLJJS5wrahCRBAulz64NHqFygjhnE&code_challenge_method=S256&state=ISfuXJZxVw4VCiEfWGEhY96pfpYA0YEo&access_type=offline&prompt=consent",
  "redirect": "https://praeko.app/conexoes/youtube/retorno",
  "expiresAt": "2026-11-07T14:12:11.482Z",
  "warning": "abra a url no navegador, autorize e volte; o retorno cai neste serviço"
}

A forma da resposta muda por rede e opção (meta com probe=true só informa, sem guardar nada); url é o que se abre no navegador.

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.