틱톡 디스플레이 API 사용에 대한 빠른 가이드

소개

오늘날의 디지털 시대에서, 소셜 미디어 통합은 개발자와 기업이 청중과 소통하는 데 점점 더 중요해졌습니다. 빠르게 성장하는 인기 덕분에, TikTok은 짧은 동영상을 공유하기 위한 강력한 플랫폼으로 떠올랐습니다. TikTok 콘텐츠를 웹사이트와 애플리케이션에 원활하게 통합할 수 있도록 하기 위해, TikTok은 개발자에게 TikTok Display API를 제공했습니다. 이 API는 개발자가 TikTok 동영상을 삽입하고 사용자 프로필을 표시하며 해시태그에 따라 동영상을 검색할 수 있게 해줍니다.

이 기사에서는 TikTok Display API 사용 과정을 안내하겠습니다. API 키를 얻는 것부터 시작하여, 그 키를 사용하여 동영상과 프로필을 검색하는 방법을 설명하겠습니다. 이 가이드를 끝마치면, 웹사이트나 애플리케이션에 TikTok 콘텐츠를 통합하여 사용자 참여와 상호작용을 증진하는 데 필요한 지식을 갖추게 될 것입니다. 그럼 시작해봅시다!

시작하기

TikTok Display API를 통해 개발자들은 TikTok 콘텐츠를 웹사이트와 애플리케이션에 원활하게 통합할 수 있습니다. 이 API를 사용하면 개발자는 TikTok 동영상을 삽입하고 사용자 프로필을 표시하며 해시태그에 따라 동영상을 검색할 수 있습니다. 이 기사에서는 TikTok Display API를 검토하고 사용자가 프로필을 얻고 사용자 동영상을 얻기 위해 어떻게 확장할 수 있는지 살펴보겠습니다.

TikTok Display API를 시작하려면, TikTok 개발자 플랫폼에 애플리케이션을 등록하고 액세스 토큰을 얻어야 합니다. 아래에는 API 키를 얻는 방법에 대한 단계별 가이드가 있습니다:

개발자 계정 만들기:

TikTok 개발자 플랫폼 웹사이트로 이동합니다. "로그인/등록" 버튼을 클릭하고 새 개발자 계정을 만듭니다. 이미 계정이 없다면 새로 생성하세요.

새 애플리케이션 등록:

이 단계에서는 TikTok 팀이 귀하의 애플리케이션을 검토하고 요구 사항을 충족하지 못하면 승인되거나 거부될 것입니다.

로그인하면 사용자 이름을 클릭하고 드롭다운 메뉴에서 "관리 앱"을 선택합니다. "생성" 버튼을 클릭하여 새 애플리케이션을 등록합니다.

애플리케이션 세부정보를 입력하라는 요청을 받을 것입니다:

앱 아이콘,
앱 이름,
카테고리,
설명,
이용 약관 & 개인 정보 보호 정책 &
플랫폼.

모든 작업이 완료되면 페이지 오른쪽 상단의 저장 버튼을 클릭하여 검토를 요청하세요.

검토를 요청하면 제출이 승인되었는지 여부를 알림을 통해 받게 됩니다. 승인되면 API 키를 생성하여 애플리케이션을 사용하라는 메시지가 표시됩니다!

인증 코드 얻기:

공식 TikTok 기사 에 따르면, Display API를 사용하기 위해서는 인증 코드와 액세스 토큰이 필요합니다.

다음 단계로 진행하려면 여기에서 인증 코드를 요청할 수 있습니다. 인증 코드를 수집한 후, 다음 단계는 이를 사용해 access token을 얻는 것입니다.

액세스 토큰을 얻는 방법에는 몇 가지 방법이 있습니다 - 가장 적합한 방법을 검토하기 위해 공식 가이드를 확인하는 것을 권장합니다.

모든 것이 예상대로 진행된다면, 다음과 같은 성공적인 응답을 볼 수 있어야 합니다;

{
    "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"
}

위 응답에서 access_token, refresh_tokens 및 만료 시점을 확인할 수 있습니다.

TikTok Display API

이제 access_token을 얻었으므로, 다음은 TikTok 표시 엔드포인트를 사용하여 사용자의 프로필이나 동영상을 검색하는 것입니다 - 원하는 것을 끌어당기면 됩니다.

TikTok 사용자 표시 엔드포인트

이미 멋진 UI가 있다면, 이 엔드포인트를 프로젝트에 간단히 통합할 수 있습니다.

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

하지만 이 가이드에서는 UI가 없기 때문에 Apidog를 사용하여 API를 테스트할 것입니다.

Apidog는 Postman과 같은 인기 있는 도구와 유사한 API 테스트를 위한 사용자 친화적인 인터페이스를 제공합니다. 직관적인 디자인과 포괄적인 기능 세트를 갖춘 Apidog은 API 테스트 및 디버깅 프로세스를 간소화하여 개발자들이 테스트 워크플로를 간소화하고 잠재적인 문제를 쉽게 식별할 수 있도록 합니다.

계정이 없다면 TikTok API 엔드포인트를 테스트하기 위해 계정을 생성하세요.

버튼

다음으로는 계정에 로그인하고 "새 요청"을 클릭하세요.

그 링크를 클릭하면 API를 테스트할 수 있는 페이지로 리디렉션됩니다.

위와 같이 첫 번째 입력란에 요청 URL을 붙여넣습니다. 인증 유형으로는 bearer token을 선택하고, 아래 토큰 필드에 토큰을 붙여넣습니다.
모든 것이 준비되면 제출 버튼을 클릭하면 응답 탭에서 응답을 볼 수 있습니다.

응답은 아래의 예시와 비슷할 것입니다;

{
   "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"
   }
}

사용자 정의 UI를 사용하는 경우, 해당 응답에서 사용자의 데이터를 추출하여 프로젝트를 구축할 수 있습니다.

사용할 수 있는 다른 표시 엔드포인트가 있으며, 공식 문서에서 확인할 수 있습니다.

결론

이 가이드에서는 TikTok Display API를 사용하여 TikTok 동영상을 삽입하고 사용자 프로필을 표시하는 방법을 살펴보았으며, 해시태그에 따라 동영상을 직접 검색하는 방법으로 확장할 수 있습니다. 이러한 단계를 따르면 사용자 참여와 상호작용을 증진시킬 수 있으며, 청중이 웹사이트나 애플리케이션을 떠나지 않고도 TikTok 콘텐츠와 상호작용할 수 있게 됩니다.

API 키를 얻고 제공된 지침을 따르면, TikTok 콘텐츠를 플랫폼에 원활하게 통합할 수 있습니다. 이 가이드가 TikTok Display API를 시작하는 데 필요한 지식을 제공했길 바랍니다.

행복한 코딩 되세요, 그리고 TikTok Display API를 프로젝트에 구현하는 모습을 기대합니다.