データ提供元とAPIパートナー

KDP123のツールのほとんどは、このブラウザの中だけで動きます。一部は、Amazonのカテゴリーリストやキーワード語句のような、ライブデータが必要です。そのリクエストはKDP123自身のサーバーを経由して、名前のある提供元に届きます。ツールは「データ提供」の行で、誰が答え、何を送ったかを示します。

リクエストの扱い

• アカウントもCookieもありません。KDP123は転送の前にCookieとログインヘッダーを取り除き、提供元が返したCookieも捨てます。KDP123のセッションは存在しないので、提供元には見えません。
• ツールに必要なものだけ。下の各エンドポイントは、入力した語句など、送る内容をそのまま列挙します。ほかの入力はこのブラウザに残ります。
• 読み取り専用で、回数制限があります。転送するのは、掲載されたパスへのGETだけです。当サーバーではIPごとの上限があり、提供元自身の1日の上限もあります。
• 静かに失敗します。提供元が止まっていると、それを必要とする部分だけが隠れ、残りは動いたままです。

現在の提供元

APIをつなぐ

KDPのデータサービスを運営していて、それを使う無料のKDP123ツールを望むなら、APIは次をすべて満たす必要があります。

1. ログインなしで動きます。訪問者は、ツールを使うために登録したり、アカウントを接続したりしません。
2. 訪問者は追跡しません。Cookie、フィンガープリント、検索内容の転売はありません。送るのは検索そのものと、利用制限のための転送IPだけです。
3. クレジットと外部リンクは問題ありません。有料の壁は不可です。ツールには名前と、サイトへの「〜で開く」リンクを表示します。中心となる答えは、KDP123上で使える必要があります。
4. 無料で、順位には影響しません。データに料金は払わず、提供元からも受け取りません。データを提供しても、自分の掲載の順序や説明は変わりません。
5. 明示した上限。訪問者あたりの1日の上限と、応答のキャッシュ時間を教えてください。ツールがその数値を表示できるようにします。
6. 出典のある数値。データの集め方を、その数値の横に表示できる1文で説明してください。

各提供元には、当サーバー上の/api/p/<provider>/パス、data/providers/<provider>.ymlの項目、転送ルールが付きます。テンプレートはリポジトリにあります。APIの資料を添えて、hello@kdp123.comまでメールしてください。

KDP123自身を呼び出しています

ディレクトリはオープンデータです。tools.jsonとtools.csv（CC BY 4.0）。各計算ツールの式とURLパラメータはcalculators.jsonにあるので、/free-tools/royalty-calculator/?price=12.99&pages=300のようなリンクで、入力済みの結果が開きます。