Um Guia Rápido para Usar a API de Exibição do TikTok

Introdução

Na era digital de hoje, a integração das mídias sociais tornou-se cada vez mais importante para desenvolvedores e empresas que buscam se engajar com seu público. Com sua popularidade em constante crescimento, o TikTok se destacou como uma plataforma poderosa para compartilhar vídeos curtos. Para facilitar a integração perfeita do conteúdo do TikTok em websites e aplicações, o TikTok disponibilizou aos desenvolvedores a TikTok Display API. Esta API permite que os desenvolvedores incorporem vídeos do TikTok, exibam perfis de usuários e busquem vídeos com base em hashtags diretamente em suas plataformas.

Neste artigo, iremos orientá-lo pelo processo de uso da TikTok Display API. Começaremos obtendo sua chave de API e, em seguida, demonstraremos como usar essa chave para recuperar vídeos e perfis. Ao final deste guia, você estará equipado com o conhecimento necessário para integrar o conteúdo do TikTok em seu website ou aplicação, aumentando o engajamento e a interação dos usuários. Vamos começar!

Começando

A TikTok Display API permite que os desenvolvedores integrem perfeitamente o conteúdo do TikTok em seus websites e aplicações. Com esta API, os desenvolvedores podem incorporar vídeos do TikTok, exibir perfis de usuários e buscar vídeos com base em hashtags diretamente em suas plataformas. Neste artigo, revisaremos a TikTok Display API e veremos como podemos usá-la para obter o perfil do usuário e estendê-la para obter os vídeos do usuário.

Para começar a usar a TikTok Display API, você precisa registrar sua aplicação na TikTok Developer Platform e obter um token de acesso. Abaixo está um guia passo a passo sobre como obter sua chave de API:

Criar uma Conta de Desenvolvedor:

Vá para o site da TikTok Developer Platform. Clique no botão "Login/Register" e crie uma nova conta de desenvolvedor se você ainda não tiver uma.

Registrar Nova Aplicação:

Nesta etapa, a equipe do TikTok revisará sua aplicação e aprovará ou negará se você não atender aos requisitos deles.

Assim que estiver logado, clique no seu nome de usuário e selecione "Gerenciar Apps" no menu suspenso. Clique no botão "Criar" para registrar uma nova aplicação.

Você será solicitado a inserir os detalhes da sua aplicação:

1. Ícone do app,
2. Nome do app,
3. Categoria,
4. Descrição,
5. Termos de Serviço & Política de Privacidade &
6. Plataforma.

Quando terminar, clique no botão de salvar no canto superior direito da página para solicitar a revisão.

Quando você solicitar a revisão, será notificado se sua submissão foi aprovada ou não. Se for aprovada, você será convidado a começar a usar seu aplicativo - criando uma chave de API!

Obtendo um Código de Autorização:

De acordo com o artigo oficial do TikTok, precisaremos de um código de autorização e um token de acesso para utilizar as Display APIs.

Você pode solicitar seu código de autorização aqui para continuar com a próxima etapa. Uma vez que você tenha coletado o código de autorização, a próxima etapa é usá-lo para obter seu token de acesso.

Existem algumas formas de obter seu token de acesso - e recomendamos verificar o guia oficial para revisar as mais adequadas para você.

Se tudo correr como esperado, você deverá ver uma resposta bem-sucedida como a seguinte;

{
    "data": {
        "access_token": "act.example12345Example12345Example",
        "captcha": "",
        "desc_url": "",
        "description": "",
        "error_code": 0,
        "expires_in": 86400,
        "log_id": "20220714041044010002007735002037040BAF34",
        "open_id": "abcdefgh-1a2b-123c4-ab12-abc123abc1234",
        "refresh_expires_in": 31536000,
        "refresh_token": "rft.example12345Example12345Example",
        "scope": "user.info.basic"
    },
    "message": "success"
}

A partir da resposta acima, você pode ver seu access_token, seus refresh_tokens, e quando eles expiram.

TikTok Display API

Agora que seu access_token foi recuperado, a próxima coisa é usar o endpoint de exibição do TikTok para recuperar o perfil ou vídeos do usuário - o que você gostaria de puxar.

Endpoint de Exibição do Usuário do TikTok

Se você já tiver uma interface bonita, pode simplesmente integrar o endpoint ao seu projeto.

https://open.tiktokapis.com/v2/user/info/?fields=open_id,union_id,avatar_url,display_name

Para este guia, no entanto, não tenho uma interface, então vou usar Apidog para testar as APIs.

Apidog fornece uma interface amigável para testar APIs, semelhante a ferramentas populares como Postman. Com seu design intuitivo e um conjunto abrangente de recursos, o Apidog simplifica o processo de teste e depuração de APIs, permitindo que os desenvolvedores otimizem seus fluxos de trabalho de testes e identifiquem possíveis problemas com facilidade.

Se você ainda não tem uma conta, crie uma conta para testar o endpoint da API do TikTok.

A próxima coisa é fazer login na sua conta e clicar em "Nova Solicitação".

Uma vez que você clique nesse link, será redirecionado para uma página para testar as APIs.

Cole a URL da solicitação no primeiro campo, conforme mostrado acima. Para o tipo de autenticação, escolha o bearer token e cole o token no campo abaixo.
Quando tudo isso estiver configurado, clique no botão Enviar, e você poderá ver sua resposta na aba de resposta.

A resposta será algo semelhante ao exemplo abaixo;

{
   "data":{
      "user":{
         "avatar_url":"https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b17f0e4b3a4f4a50993cf72cda8b88b8~c5_168x168.jpeg",
         "open_id":"723f24d7-e717-40f8-a2b6-cb8464cd23b4",
         "union_id":"c9c60f44-a68e-4f5d-84dd-ce22faeb0ba1",
         "display_name": "Tik Toker"
      }
   },
   "error":{
      "code":"ok",
      "message":"",
      "log_id":"20220829194722CBE87ED59D524E727021"
   }
}

Se você estiver usando uma interface personalizada, pode extrair os dados do usuário dessa resposta para construir seu projeto.

Existem outros endpoints de exibição que você pode usar, e você pode verificá-los aqui na documentação oficial.

Conclusão

Na era digital de hoje, a integração das mídias sociais tornou-se cada vez mais importante para desenvolvedores e empresas que buscam se engajar com seu público. Com sua popularidade em constante crescimento, o TikTok se destacou como uma plataforma poderosa para compartilhar vídeos curtos. Para facilitar a integração perfeita do conteúdo do TikTok em websites e aplicações, o TikTok disponibilizou aos desenvolvedores a TikTok Display API.

Ao longo deste guia, exploramos como utilizar a TikTok Display API para incorporar vídeos do TikTok e exibir perfis de usuários, e você pode estendê-la para buscar vídeos com base em hashtags diretamente em sua plataforma. Ao seguir essas etapas, você pode aumentar o engajamento e a interação dos usuários, permitindo que seu público interaja com o conteúdo do TikTok sem sair de seu website ou aplicação.

Ao obter sua chave de API e seguir as instruções fornecidas, você pode integrar perfeitamente o conteúdo do TikTok em sua plataforma. Esperamos que este guia tenha fornecido o conhecimento necessário para começar a usar a TikTok Display API.

Feliz codificação, e estamos ansiosos para ver como você implementa a TikTok Display API em seus projetos.