Skip to content

getting-started.mdx

Latest commit

 

History

History
124 lines (83 loc) · 2.58 KB

getting-started.mdx

File metadata and controls

124 lines (83 loc) · 2.58 KB
title Início rápido
description Teste a Social API em segundos usando o ambiente de produção

Bora testar? O jeito mais rápido é usar o ambiente de produção direto — sem instalar nada.

Base URL

https://social-api.appconty.com

Documentação Swagger: https://social-api.appconty.com/docs/

1. Healthcheck

Primeiro, vamos ver se tá tudo no ar:

curl https://social-api.appconty.com/health

Resposta esperada:

OK

Se retornou OK, a API tá funcionando. Se retornou DB_UNHEALTHY (503), tem algo errado com o banco.

2. Configurar autenticação

Agora vamos configurar os headers necessários:

export INTERNAL_SECRET="sua-chave-secreta"
export ENTERPRISE_ID="123e4567-e89b-12d3-a456-426614174000"
O `ENTERPRISE_ID` precisa ser um UUID v4 válido. Você pode gerar um em [uuidgenerator.net](https://www.uuidgenerator.net/).

3. Conectar uma conta

Vamos conectar um perfil do Instagram:

curl -X POST https://social-api.appconty.com/connect \
  -H "X-Internal-Secret: $INTERNAL_SECRET" \
  -H "X-Enterprise-Id: $ENTERPRISE_ID" \
  -H "Content-Type: application/json" \
  -d '{"username": "neymarjr", "platform": "INSTAGRAM"}'

Pra TikTok, só trocar o platform:

-d '{"username": "khaby.lame", "platform": "TIKTOK"}'

4. Listar contas

Ver todas as contas que você conectou:

curl https://social-api.appconty.com/accounts \
  -H "X-Internal-Secret: $INTERNAL_SECRET" \
  -H "X-Enterprise-Id: $ENTERPRISE_ID"

5. Ver o dashboard

Com o ID da conta, você pode ver o dashboard consolidado:

curl "https://social-api.appconty.com/accounts/{id}/dashboard?limit=10" \
  -H "X-Internal-Secret: $INTERNAL_SECRET" \
  -H "X-Enterprise-Id: $ENTERPRISE_ID"

🎉 Pronto! Você já tá usando a Social API.

Lembre-se: a Social API é **interna** e não deve ser chamada de apps públicos.

Quer rodar localmente?

Se você precisa desenvolver ou contribuir com a API:

Configure com Go + Make pra desenvolver e iterar Ambiente isolado sem instalar Go

Próximos passos

Agora que você testou, recomendo entender os conceitos:

Account, Post, Metrics, Snapshot, Job — como tudo se conecta