超ときめき♡研究部

超ときめき♡API

超ときめき♡研究部のページ生成の元となるデータの一部を REST API として提供しています

ご利用にあたって

  • ご利用はいただくことによる生じたいかなる不利益についても責任を負いかねます
  • 予告なく API の提供を中断・停止することがございます

エンドポイント

https://api.tokiken.com

TLS 1.2 での接続が必須となります

実行可能なアクション

GET /songs

アクション内容

楽曲リストを取得します。

返却値

Song エンティティの配列を返却します。

実行例

https://api.tokiken.com/songs

GET /songs/{songId}

アクション内容

{songId} で指定した楽曲を取得します。{songId} は各楽曲に振られた一意な識別子であり GET /songs アクションで各楽曲の {songId} の確認が可能です。

返却値

Song エンティティを返却します。

実行例

https://api.tokiken.com/songs/サンタさんがやってこない

GET /songs/{songId}/credits

アクション内容

{songId} で指定した楽曲のクレジット一覧を取得します。

返却値

Credit エンティティの配列を返却します。

実行例

https://api.tokiken.com/songs/サンタさんがやってこない/credits

GET /records

アクション内容

レコードのリストを取得します。レコードは「STAR」のようにリリースされたシングルやアルバムを指します。

返却値

Record エンティティの配列を返却します。

実行例

https://api.tokiken.com/records

GET /record/{recordId}

アクション内容

{recordId} で指定したレコードを取得します。{recordId} は各レコードに振られた一意な識別子であり GET /records アクションで各レコードの {recordId} の確認が可能です。

返却値

Record エンティティを返却します。

実行例

https://api.tokiken.com/records/ハートギュッと

GET /editions

アクション内容

レコード盤のリストを取得します。レコード盤は「ときめきがすべて」としてリリースされたレコードのうち「たまありみるみる盤」のようにシングルやアルバムの盤(形態)を指します。

返却値

RecordEdition エンティティの配列を返却します。

実行例

https://api.tokiken.com/editions

GET /editions/{catalogNumber}

アクション内容

{catalogNumber} で指定したレコード盤を取得します。{catalogNumber} は原則として各レコード盤の規格品番となっていますがデジタルリリース盤などの場合、独自の識別子が割り当てられています。GET /editions アクションで各レコード盤の {catalogNumber} の確認が可能です。

返却値

RecordEdition エンティティを返却します

実行例

https://api.tokiken.com/editions/AVCD-96983A

GET /editions/{catalogNumber}/tracks

アクション内容

{catalogNumber} で指定したレコード盤のトラック一覧を取得します。トラックとは各 CD/DVD/Blu-ray のトラックやチャプタそのものを指します。

返却値

Track エンティティの配列を返却します。

実行例

https://api.tokiken.com/editions/AVCD-96983A/tracks

GET /artists

アクション内容

アーティストのリストを取得します。アーティストとは楽曲に携わった作詞/作曲/編曲家やレコーディングエンジニア、振付師などを指します。

返却値

Artists エンティティの配列を返却します。

実行例

https://api.tokiken.com/artists

GET /artists/{artistId}

アクション内容

{artistId} で指定したアーティストを取得します。GET /artists アクションで各アーティストの {artistId} の確認が可能です。

返却値

Artists エンティティを返却します

実行例

https://api.tokiken.com/artists/浅利進吾

GET /artists/{artistId}/credits

アクション内容

{artistId} で指定したアーティストのクレジット一覧を取得します

返却値

Credit エンティティの配列を返却します。

実行例

https://api.tokiken.com/artists/浅利進吾/credits