Content Classifiers - Classify

Serviço:

Azure AI Services

Versão da API:

2025-05-01-preview

Classifique o conteúdo com divisão opcional.

POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview

Com parâmetros opcionais:

POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview&stringEncoding={stringEncoding}&processingLocation={processingLocation}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
classifierId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	O identificador exclusivo do classificador.
endpoint	path	True	string (uri)	Ponto de extremidade de serviço de Compreensão de Conteúdo.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
processingLocation	query		ProcessingLocation	O local onde os dados podem ser processados.
stringEncoding	query		StringEncoding	O formato de codificação do conteúdo abrange a resposta.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-request-id		string (uuid)	Um identificador de cadeia de caracteres opaco, globalmente exclusivo e gerado pelo cliente para a solicitação.

Corpo da solicitação

Nome	Tipo	Description
url	string (uri)	A URL do documento a ser classificado.

Respostas

Nome	Tipo	Description
202 Accepted		A solicitação foi aceita para processamento, mas o processamento ainda não foi concluído. Cabeçalhos Operation-Location: string x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize
URL do Token: https://login.microsoftonline.com/common/oauth2/token

Escopos

Nome	Description
https://cognitiveservices.azure.com/.default

Exemplos

Classify URL

Solicitação de exemplo

HTTP

POST {endpoint}/contentunderstanding/classifiers/myClassifier:classify?api-version=2025-05-01-preview

{
  "url": "https://host.com/doc.pdf"
}

Resposta de exemplo

Código de status:

202

Operation-Location: https://myendpoint.cognitiveservices.azure.com/contentunderstanding/classifierResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-05-01-preview

{
  "id": "3b31320d-8bab-4f88-b19c-2322a7f11034",
  "status": "NotStarted"
}

Definições

Nome	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta que contém detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
ClassifyRequest	Classifique a solicitação de operação.
ProcessingLocation	O local onde os dados podem ser processados.
StringEncoding	A codificação de cadeia de caracteres usada para extensões de conteúdo.

Azure.Core.Foundations.Error

Objeto

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação do erro em formato legível por humanos.
target	string	O destino do erro.

Azure.Core.Foundations.ErrorResponse

Objeto

Uma resposta que contém detalhes do erro.

Nome	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Objeto

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

ClassifyRequest

Objeto

Classifique a solicitação de operação.

Nome	Tipo	Description
url	string (uri)	A URL do documento a ser classificado.

ProcessingLocation

Enumeração

O local onde os dados podem ser processados.

Valor	Description
dataZone	Os dados podem ser processados na mesma zona de dados que o recurso.
geography	Os dados podem ser processados na mesma geografia que o recurso.
global	Os dados podem ser processados em qualquer data center do Azure globalmente.

StringEncoding

Enumeração

A codificação de cadeia de caracteres usada para extensões de conteúdo.

Valor	Description
codePoint	Codificação de ponto de código Unicode (UTF-32), usada por linguagens como Python, etc.
utf16	Codificação UTF-16, usada por linguagens como C#, JavaScript, Java, etc.
utf8	Codificação UTF-8, usada por linguagens como Go, Rust, Ruby, PHP, etc.