Similarity Determination API

以下は、APIキーのチェック機能を含めた類似度判定APIのリファレンスです。


概要

このAPIは、2つの単語の類似度を計算し、単語が同一かどうかと類似スコアを返します。APIの利用には有効なAPIキーが必要で、エンドポイントは https://events-front.mixeder.net/v2/similar です。APIキーはクエリパラメータ、POSTデータ、またはリクエストヘッダーから提供できます。


エンドポイント

GET /v2/similar

認証

認証には、以下の方法でAPIキーを提供する必要があります。

  1. クエリパラメータ: ?key=YOUR_API_KEY

  2. POSTデータ: api-key=YOUR_API_KEY

  3. ヘッダー: api-key: YOUR_API_KEY

クエリパラメータ

パラメータ
必須
説明

word1

はい

比較したい最初の単語を指定します

word2

はい

比較したい2つ目の単語を指定します

key

はい

APIキー

レスポンス

レスポンスはJSON形式で返され、以下の情報が含まれます。

フィールド
タイプ
説明

isSame

boolean

true ならば word1word2 は同じ

similarityScore

float

0~100 の範囲で示される類似度スコア

使用例

1. 正しいAPIキーと単語を指定する場合

リクエスト:

GET https://events-front.mixeder.net/v2/similar?word1=hello&word2=halo&key=YOUR_API_KEY

レスポンス:

{
    "isSame": false,
    "similarityScore": 75
}

2. 無効なAPIキーの場合

リクエスト:

GET https://events-front.mixeder.net/v2/similar?word1=hello&word2=halo&key=INVALID_KEY

レスポンス:

API key is wrong

3. APIキーが提供されていない場合

リクエスト:

GET https://events-front.mixeder.net/v2/similar?word1=hello&word2=world

レスポンス:

API Key not provided.

使用上の注意

  • APIキーが無効な場合にはエラーメッセージが返されます。


このAPIは、単語の比較や類似性のチェックを手軽に行うために設計されており、フィルタリング、データクレンジング、入力補完などの用途に活用可能です。

最終更新

役に立ちましたか?