ジャンプ先

• リクエスト
• レスポンス

最も関連性の高いキーワードの取得

post

/omlmod/v1/cognitive-text/keywords

指定されたテキスト文字列のリストに最も関連性の高いキーワードを返す認識テキスト・エンドポイント。topNのパラメータを入力の一部として渡して、ドキュメントごとに返すキーワードの数を決定できます。デフォルトでは、5つのキーワードが返されます。コール元は、言語パラメータを渡すこともできます。キーワードは重みでソートされます。

リクエスト

この操作にはリクエスト・パラメータはありません。

サポートされているメディア・タイプ

• application/json

リクエスト本文 - application/json ()

ルート・スキーマ : schema

型: object

ソースの表示

• language: string
  使用可能な値: [ "AMERICAN", "SPANISH", "FRENCH", "ITALIAN" ]
• textList(required): array textList
• topN: integer
  最小値: 1

  デフォルト値: 5

{
    "required":[
        "textList"
    ],
    "properties":{
        "textList":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "topN":{
            "type":"integer",
            "minimum":1,
            "default":5
        },
        "language":{
            "type":"string",
            "enum":[
                "AMERICAN",
                "SPANISH",
                "FRENCH",
                "ITALIAN"
            ]
        }
    }
}

ネストされたスキーマ : textList

型: array

ソースの表示

• 配列: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

重みおよび関連するテキスト文字列を含むキーワードのリスト。

本文()

ルート・スキーマ : schema

型: array

ソースの表示

• 配列: object KeywordResponse

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/KeywordResponse"
    }
}

ネストされたスキーマ : KeywordResponse

型: object

ソースの表示

• keywordResults(required): array keywordResults
• text(required): string

{
    "required":[
        "text",
        "keywordResults"
    ],
    "properties":{
        "text":{
            "type":"string"
        },
        "keywordResults":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/KeywordResult"
            }
        }
    }
}

ネストされたスキーマ : keywordResults

型: array

ソースの表示

• 配列: object KeywordResult

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/KeywordResult"
    }
}

ネストされたスキーマ : KeywordResult

型: object

ソースの表示

• keyword(required): string
• weight(required): number (double)

{
    "required":[
        "keyword",
        "weight"
    ],
    "properties":{
        "keyword":{
            "type":"string"
        },
        "weight":{
            "type":"number",
            "format":"double"
        }
    }
}

400レスポンス

不正なリクエストです。

本文()

ルート・スキーマ : Error

型: object

ソースの表示

• code(required): string
• message(required): string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

401レスポンス

認可されていません。

本文()

ルート・スキーマ : Error

型: object

ソースの表示

• code(required): string
• message(required): string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

404レスポンス

リソースが見つかりません。

本文()

ルート・スキーマ : Error

型: object

ソースの表示

• code(required): string
• message(required): string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

500レスポンス

予期しないエラーです。

本文()

ルート・スキーマ : Error

型: object

ソースの表示

• code(required): string
• message(required): string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

先頭に戻る