Official Joke API

ランダムなジョークを読み込み、id、type、setup、punchline を一つの応答の要素として確認できます。

公式ドキュメント

現在の公開データ

英語のジョークを読み込み、type、setup、punchline を合わせて確認します。id は項目を識別しますが、本文を翻訳したり、すべての読者に適切と判断したりするものではありません。

レスポンスに含まれる項目

ランダムなジョークを読み込み、id、type、setup、punchline を一つの応答の要素として確認できます。

応答はテスト、娯楽向け画面、連携例に使えます。ジョークは事実でも推奨でもなく、すべての読者に自動的に適する内容でもありません。人、年齢、特別な規則が関わる場面で表示する前に本文を確認してください。

確認したい項目

id: ジョークの識別子
type: カテゴリ
setup と punchline: 本文とオチ

応答の読み方

ボタンは GET /random_joke を使用し、id、type、setup、punchline を含むオブジェクトを返します。setup はジョークの前半、punchline はオチです。type は返されたカテゴリを整理します。一文だけを表示する前に全体を読んでください。

id は API が返した項目を識別します。
setup と punchline は二つの部分からなる一つのジョークです。
type は分類であり、品質や適合性の評価ではありません。

このページでは一件ずつ

サービスのトップページには /random_joke、/random_ten、/jokes/random などのルートがあります。このボタンが呼び出すのは /random_joke だけで、話題による検索、翻訳、読者向けの絞り込みは行いません。別の流れでは、ソースでルートと応答を確認してください。

再読み込みでランダムな項目は変わりますが、特定の話題は保証されません。
複数件を返すルートは、このページで使う呼び出しとは別です。
ページの表示言語にかかわらず、返された本文は英語です。

文脈を付けて再利用する

短いジョークは視覚テスト、気晴らし、構造化された応答のデモに使えます。事実を証明するものではなく、環境、年齢層、コミュニティに適した伝達の代わりにもなりません。実験外で再公開する前にメッセージを確認してください。

ジョークを事実や助言として示さないでください。
ランダムな本文がすべての読者に合うと考えないでください。
公開製品で結果を自動表示する前に、独自のモデレーションと利用基準を定めてください。