読者です 読者をやめる 読者になる 読者になる

shucreamTech

web系エンジニアが意識低く書くブログ

PHP7.1向けのツイキャスAPI用のライブラリを作った

これは何

f:id:shucream0117:20170317204053p:plain

日本最大級のライブ配信サービス『TwitCasting(ツイキャス)』の新しいAPIが少し前に公開され、ハッカソンも大盛況だったようですね!!

そんなツイキャスのAPIをPHP(≧7.1)で扱いやすくするためのライブラリを作ってみました。

kwsk

リポジトリはこちらです→ https://github.com/shucream0117/twitcasting-oauth

composerでインストール可能で、

$ php composer.phar require shucream0117/twitcasting-oauth:dev-master

でOK。

他、詳しい例などは README や こちらのサンプルアプリケーションをご覧ください。

ユーザーのアクセストークンでAPIを実行する場合と、アプリのClientID+ClientSecretでリクエストする場合で使用するExecutorのオブジェクトが変わるので注意して下さい。(この辺もREADME参照)

また、2xx系のレスポンス以外の場合、各ステータスコードごとに例外がスローされるので適当にハンドリングする必要があります。

最後に、大まかにこのライブラリで出来ることと出来ないことを書いておきます。

出来ること

  • アクセストークン取得処理の簡略化
  • REST APIへのリクエスト処理簡略化
    • 主にこれです
    • 必要なヘッダーを付加してCRUDのリクエストを投げてくれるhttpクライアントという感じ

出来ないこと

  • ImplicitFlowでのアクセストークン取得
    • 認可フローの違いについては こちら をご覧下さい
  • RealTimeAPI(WebSocket)への対応

おわり

PHP7.1.x向けということで、そのままでは使える場面が限定されてしまうかもしれませんが、強い心で古いバージョンを切り捨てました。 宜しくお願いします。