Documentação API TikTok

Integre sua aplicação com a plataforma GanheSocial e automatize suas operações

Introdução

A API do GanheSocial permite que desenvolvedores integrem suas aplicações com nossa plataforma para automatizar o processo de execução de ações em redes sociais.

1

Autenticação

Todas as requisições requerem um token de autenticação válido.

2

Fluxo de Trabalho

O fluxo padrão consiste em três etapas: obter ID da conta, obter ação e confirmar ação.

3

Respostas

Todas as respostas são retornadas no formato JSON com códigos de status HTTP padrão.

Autenticação

Todas as requisições à API do GanheSocial requerem autenticação através de um token. O token deve ser incluído como parâmetro em todas as requisições.

GET Parâmetro de Autenticação

Adicione o token como parâmetro de consulta em todas as requisições:

?token=SEU_TOKEN_AQUI
Parâmetro Tipo Obrigatório Descrição
token String Sim Token de autenticação do usuário

Endpoints da API

Obter ID da Conta

GET /api/tiktok/get_user

Obtém o ID único da conta TikTok baseado no nome de usuário.

https://ganhesocial.com/api/tiktok/get_user?token={token}&nome_usuario={nome_usuario}

Parâmetros

Parâmetro Tipo Obrigatório Descrição
token String Sim Token de autenticação
nome_usuario String Sim Nome de usuário do TikTok

Exemplo de Requisição

const response = await fetch(`https://ganhesocial.com/api/tiktok/get_user?token=${token}&nome_usuario=${nomeUsuario}`);
const data = await response.json();

Resposta de Sucesso

{
 status: 'success',                             
 id_tiktok: '123456789'
}

Obter Ação

GET /api/tiktok/get_action

Obtém uma ação disponível para execução.

https://ganhesocial.com/api/tiktok/get_action?token={token}&id_tiktok={id_tiktok}&tipo={tipo}

Parâmetros

Parâmetro Tipo Obrigatório Descrição
token String Sim Token de autenticação
id_tiktok String Sim ID da conta TikTok
tipo Number Sim Tipo de ação (1 = seguir, 2 = curtir, 3 = seguir e curtir)

Exemplo de Requisição

const response = await fetch(`https://ganhesocial.com/api/tiktok/get_action?token=${token}&id_tiktok=${idtiktok}&tipo=1`);
const data = await response.json();

Resposta de Sucesso

{
  status: 'sucess',
  id_tiktok: '123456789',
  id_action: '123456789',
  url: 'https://www.tiktok.com/@usuariodotiktok',
  nome_usuario: 'usuariodotiktok',
  tipo_acao: 'seguir',
  valor: '0.006'
}

Confirmar Ação

POST /api/tiktok/confirm_action

Confirma a execução de uma ação previamente obtida.

https://ganhesocial.com/api/tiktok/confirm_action

Parâmetros (Body JSON)

Parâmetro Tipo Obrigatório Descrição
token String Sim Token de autenticação
id_action String Sim ID da ação a ser confirmada
id_tiktok String Sim ID da conta TikTok

Exemplo de Requisição

const response = await fetch("https://ganhesocial.com/api/tiktok/confirm_action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    token: token,
    id_action: idaction,
    id_tiktok: idtiktok
  })
});

Resposta de Sucesso

{
  status: 'sucess',
  message: 'ação confirmada com sucesso',
  valor: 0.006
}

Exemplo Completo

Aqui está um exemplo completo do fluxo de integração com a API:

// Configurações
const token = "SEU_TOKEN_AQUI";
const nomeUsuario = "SEU_NOME_DE_USUARIO_TIKTOK_AQUI";

async function executarFluxo() {
  try {
    // 1. Obter ID da conta
    const getUserResponse = await fetch(`https://ganhesocial.com/api/tiktok/get_user?token=${token}&nome_usuario=${nomeUsuario}`);
    const userData = await getUserResponse.json();

    if (!userData.id_tiktok) throw new Error("id_tiktok não encontrado.");
    const idtiktok = userData.id_tiktok;

    // 2. Obter ação
    const getActionResponse = await fetch(`https://ganhesocial.com/api/tiktok/get_action?token=${token}&id_tiktok=${idtiktok}&tipo=1`);
    const actionData = await getActionResponse.json();

    if (!actionData.id_action) throw new Error("id_action não encontrado.");
    const idaction = actionData.id_action;

    // 3. Confirmar ação
    const confirmResponse = await fetch("https://ganhesocial.com/api/tiktok/confirm_action", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        token: token,
        id_action: idaction,
        id_tiktok: idtiktok
      })
    });

    const confirmData = await confirmResponse.json();
    console.log(" Ação concluída com sucesso!", confirmData);
  } catch (error) {
    console.error("Erro no fluxo:", error.message);
  }
}

executarFluxo();