Links de conexão
Crie um link para que um cliente conecte as contas sociais dele ao seu espaço de trabalho sem entrar na AdaptlyPost, e revogue-o quando terminar.
Permissão: accounts.manage. Veja Papéis e permissões.
Só uma chave de Administrador tem accounts.manage, então só chaves de Administrador podem criar ou revogar links de conexão.
Um link de conexão abre uma página onde alguém sem conta AdaptlyPost conecta as contas sociais dele ao seu espaço de trabalho. Envie a url a um cliente, ele aprova cada plataforma e as contas aparecem em Social Accounts como qualquer outra.
POST /api/v1/connect-links
Todos os campos são opcionais. Sem corpo, você recebe um link rápido: ele oferece todas as plataformas, mostra ao cliente todas as contas do espaço de trabalho, conecta qualquer número de contas e deixa de funcionar em 7 dias.
| Campo | Tipo | Descrição |
|---|---|---|
name | string, até 80 caracteres | Rótulo na lista de links do painel. Só a sua equipe vê |
visibility | PUBLIC ou PRIVATE | PRIVATE mostra ao cliente só as contas que ele conectou por este link. O padrão é PUBLIC |
allowedPlatforms | array de tipos de plataforma | Plataformas que o cliente pode escolher. Omita ou envie [] para todas |
maxAccounts | inteiro, 1 ou mais | O link deixa de funcionar quando essa quantidade de contas for conectada por ele. Reconectar uma conta que ele já conectou não conta de novo |
expiresAt | data e hora ISO 8601 com Z ou um deslocamento | Quando o link deixa de funcionar. Entre 1 hora e 365 dias a partir de agora. O padrão é daqui a 7 dias |
neverExpires | booleano | true mantém o link funcionando até ser revogado. Não envie junto com expiresAt |
Exemplo de requisição:
{
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3,
"expiresAt": "2026-11-30T18:00:00Z"
}Devolve 201:
{
"url": "https://adaptlypost.com/connect/9f2c4e71b0d8...",
"token": "9f2c4e71b0d8...",
"expiresAt": "2026-11-30T18:00:00.000Z",
"name": "Acme onboarding",
"visibility": "PRIVATE",
"allowedPlatforms": ["INSTAGRAM", "TIKTOK"],
"maxAccounts": 3
}| Campo | Descrição |
|---|---|
url | A página a enviar. Quem a tiver pode conectar contas a este espaço de trabalho enquanto o link funcionar |
token | Identifica o link. Guarde-o para revogar o link depois |
expiresAt | Quando o link deixa de funcionar, ou null para um link que nunca expira |
name, visibility, allowedPlatforms, maxAccounts | As configurações com que o link foi criado. name e maxAccounts são null quando não definidos |
Um expiresAt fora do intervalo, ou expiresAt junto com neverExpires, devolve 400 com uma mensagem dizendo o motivo.
Um link também deixa de funcionar assim que é revogado, quando já conectou maxAccounts contas, ou quando o membro que o criou já não pode gerenciar contas no espaço de trabalho.
DELETE /api/v1/connect-links/:token
Revoga o link na hora. As contas já conectadas por ele continuam conectadas. Devolve { "success": true }, ou 404 quando nenhum link deste espaço de trabalho tem esse token.