Chat Thread - Get Chat Thread Properties

Servizio:

Communication

Versione API:

2024-03-07

Ottiene le proprietà di un thread di chat.

GET {endpoint}/chat/threads/{chatThreadId}?api-version=2024-03-07

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
chatThreadId	path	True	string	ID del thread.
endpoint	path	True	string	Endpoint della risorsa di comunicazione di Azure.
api-version	query	True	string	Versione dell'API da richiamare.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Risposte

Nome	Tipo	Descrizione
200 OK	ChatThreadProperties	Richiesta riuscita. L'azione restituisce un thread di chat.
401 Unauthorized	CommunicationErrorResponse	Non autorizzato.
403 Forbidden	CommunicationErrorResponse	Vietato.
429 Too Many Requests	CommunicationErrorResponse	Troppe richieste.
Other Status Codes	CommunicationErrorResponse	Servizio non disponibile.

Sicurezza

Authorization

Un token di accesso utente ACS (Servizi di comunicazione di Azure).

Tipo: apiKey
In: header

Esempio

Get chat thread

Esempio di richiesta

HTTP

GET https://contoso.westus.communications.azure.com/chat/threads/19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2?api-version=2024-03-07

Risposta di esempio

Codice di stato:

200

{
  "id": "19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2",
  "topic": "Lunch",
  "createdOn": "2020-06-06T05:55:41.6460000Z",
  "createdByCommunicationIdentifier": {
    "rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
    "communicationUser": {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
    }
  }
}

Codice di stato:

401

{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}

Codice di stato:

403

{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}

Codice di stato:

429

{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}

Codice di stato:

503

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

Definizioni

ChatThreadProperties

Thread di chat.

Nome	Tipo	Descrizione
createdByCommunicationIdentifier	CommunicationIdentifierModel
createdOn	string	Timestamp al momento della creazione del thread di chat. Il timestamp è in formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
deletedOn	string	Timestamp quando il thread di chat è stato eliminato. Il timestamp è in formato RFC3339: yyyy-MM-ddTHH:mm:ssZ.
id	string	ID thread di chat.
topic	string	Argomento del thread di chat.