Twitcasting API 사용 방법

Twitcasting은 트위터 또는 페이스북 계정을 사용해 스트리밍과 방송을 가능하게 하는 애플리케이션입니다. API를 이용해서 스트리머의 방송정보를 가져올 수도 있고 방송을 시작할 수도 있습니다.

앱 생성

API를 사용하려면 트윗케스팅 계정이 필요합니다. 트위터나 페이스북으로 로그인을 해줍시다.
로그인을 한 후 https://twitcasting.tv/developer.php 에 들어가서 앱을 하나 만들어봅시다.앱의 상세정보를 넣어주고 create 버튼을 누르게 되면 생성이 됩니다.

callback url은 토큰을 받기위한 경로임으로 실제로 돌고 있는 애플리케이션의 url이 아니여도 됩니다.
Scope: 읽기 전용(Read Only), Write기능 포함(Read and Write), Broadcast기능 포함(Read, Write and Broadcast)

만든 앱이 떡하니 생성됬네요. 클릭해서 상세정보를 가져와봅시다.ClientID와 ClientSecret 정보가 가장 중요하니 어딘가에 저장하도록 합시다.

Access Token 받기

https://apiv2.twitcasting.tv/oauth2/authorize?client_id={YOUR_CLIENT_ID}&response_type=token&state={CSRF_TOKEN}

위의 URL을 통해서 Access Token을 받을 수 있습니다. {YOUR_CLIENT_ID} 대신에 앱의 ClientID를 넣어줍시다.파란색인 버튼을 클릭하는것으로 이 앱의 이용을 허가하게 됩니다.설정해두었던 Callback Url(localhost:3000)을 통해서 access token을 받았습니다.

{YOUR_CALLBACK_URL}#access_token={ACCESS_TOKEN}&token_type=bearer&expires_in=15552000&state={CSRF_TOKEN}

위와 같은 형식의 URL에서 {ACCESS_TOKEN}의 값만 어딘가에 저장하도록 합시다.*이 access_token은 180일 이후에 사용할 수 없게 되며 새로운 access_token을 발급받기 위해서는 새로운 앱을 생성해야 합니다.

API 사용

Access token을 이용해 크롬 브라우저에서 API를 사용해보겠습니다.
트윗캐스팅 API Documentation

이 API는 리퀘스트 해더를 통해서 사용해야 함으로 크롬에서 확인 할 경우 ModHeader라는 크롬 확장 툴을 받아야 합니다.https://chrome.google.com/webstore/detail/modheader/idgpnmonknjnojddfkpgkljpfnnfcklj

JSON값이 돌아오기 때문에 JSON값을 잘 보여주는 JSON Formatter라는 툴도 받아줍니다.https://chrome.google.com/webstore/detail/json-formatter/bcjindcccaagfpapjjmafapmmgkkhgoa

유저를 검색해서 정보를 받아오는 예를 들어서 API를 사용해보겠습니다. words와 lang 패러미터가 꼭 필요한것 같으니 패러미터로 넣어서 리퀘스트를 보내보겠습니다.

https://apiv2.twitcasting.tv/search/users?words=ツイキャス+公式&lang=ja

리퀘스트 헤더없이 API를 사용하거나 Access token이 invalid한 경우에 이런 리퀘스트가 돌아오게 됩니다. 그렇기 때문에 ModHeader를 열고 리퀘스트 헤더를 설정해주어야 합니다.

+버튼으로 헤더를 추가하고 Authorization헤더의 값은

Bearer [받은 Access Token 값]

으로 설정해줍니다.

정보가 성공적으로 받아지는것을 확인할 수 있습니다.