Jump to

• Request
• Response

Get Most Relevant Topics

post

/omlmod/v1/cognitive-text/topics

A cognitive text endpoint that returns the most relevant topics for the provided list of text strings. A parameter of topN can be passed as part of input to determine how many topics to return. By default, 2 topics will be returned. Callers can also pass a language parameter. The topics will be sorted by weight.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• language: string
  Allowed Values: [ "AMERICAN", "SPANISH", "FRENCH", "ITALIAN" ]
• textList(required): array textList
• topN: integer
  Minimum Value: 1

  Default Value: 2

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

Nested Schema : textList

Type: array

Show Source

• Array of: string

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

Back to Top

Response

Supported Media Types

• application/json

200 Response

A list of topics with weights and the associated text strings.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object TopicResponse

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

Nested Schema : TopicResponse

Type: object

Show Source

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

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

Nested Schema : topicResults

Type: array

Show Source

• Array of: object TopicResult

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

Nested Schema : TopicResult

Type: object

Show Source

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

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

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Show Source

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

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

401 Response

Unauthorized.

Body ()

Root Schema : Error

Type: object

Show Source

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

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

404 Response

Resource not found.

Body ()

Root Schema : Error

Type: object

Show Source

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

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

500 Response

Unexpected error.

Body ()

Root Schema : Error

Type: object

Show Source

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

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

Back to Top