めざましじゃんけん 広場

めざましじゃんけんの予想登録を行い、テレビの放送結果と連動し、ほかの参加者とじゃんけんを楽しみます。

利用方法

Card image cap



めざましじゃんけん広場 API予想登録方法

APIを利用しためざましじゃんけん予測のサンプルスクリプト

Python KerasのLSTMを用いた時系列予測でめざましじゃんけんの予想を行うチュートリアルはこちら

APIKEYの取得

API利用時には、APIトークンを利用します。はじめにWEBサイトよりAPIトークンを取得します。

Overview image

API仕様

WEBサイトより取得した、APIトークンを、Authorization: Bearer ヘッダとして、Headerに指定し、APIの実行を行います。JSON形式でデーターの送受信を行います。200、201、204、400、401、403、404、500の8種類のステータスコードを利用します。

また、ステータスコードに加えて、Header内のRleamや本文内に、適時メッセージを応答します。


API機能一覧

# API名 mod 機能概要
1000 じゃんけん予想更新 updatePredict じゃんけん予想の新規追加および更新
2000 じゃんけん結果一括取得 getAllHistory システムに登録されているじゃんけん結果の一括取得


【1000】じゃんけん予想更新

プレイヤーの出し手を登録。

POSTデーター

例:"mod": "updatePredict", "date": "2020-04-08", "times": 1, "predict": 1}
 2020年04月08日1戦目のプレイヤーの出し手に✊ グーを登録。

Key 必須 値の説明
mod テキスト ○(固定) updatePredict
date Y-m-d 日付形式
"2019-10-01"
predict 数値 1:✊グー、2:✌チョキ、3:✋:パー
times 数値 じゃんけん何戦目か。"2"を指定した際は、2戦目


返却データ

例:{"status":"Success","text":"正常にアップデートされました"}

Key 必須 値の説明
status テキスト 終了コード
text テキスト 終了時のメッセージ


【2000】じゃんけん結果一括取得

システムに登録されているめざましじゃんけんの結果を一括取得。

POSTデーター

例:{"mod": "getAllHistory"}
 システムに登録されているめざましじゃんけんの結果を一括取得。

Key 必須 値の説明
mod テキスト ○(固定) getAllHistory


返却データ

例:[{"date":"2019-07-29","times":"1","tv":"1","who":"まちかどじゃんけん"},{"date":"2019-07-29","times":"2","tv":"3","who":"志田未来さん"},{"date":"2019-07-29","times":"3","tv":"1","who":"りんごちゃん"},{"date":"2019-07-29","times":"4","tv":"2","who":"内藤剛志さん"},{"date":"2019-07-30","times":"1","tv":"3","who":"まちかどじゃんけん"},{"date":"2019-07-30","times":"2","tv":"2","who":"三浦貴大さん"},{"date":"2019-07-30","times":"3","tv":"1","who":"長州力さん"},{"date":"2019-07-30","times":"4","tv":"3","who":"久慈暁子アナウンサー"},

Key 必須 値の説明
date Y-m-d 日付形式
"2019-10-01"
times 数値 じゃんけん何戦目か。"2"を指定した際は、2戦目
tv 数値 テレビ側のじゃんけんの出し手
1:✊グー、2:✌チョキ、3:✋:パー
who テキスト じゃんけんの対戦相手


PHPサンプルコード


Pythonサンプルコード


curlコマンドで実行例

curl -v -X POST "https://janken.own-cloud.com/jankenApi.php" \
-H "Authorization: Bearer @@API_KEY@@" \
-H "Content-Type: application/json" \
-d "{\"mod\": \"updatePredict\",\"date\": \"2019-10-01\",\"times\": 1,\"predict\": 1}"