Get Chat Thread - Get Chat Thread

Hizmet:: Communication

API Sürümü:: 2020-09-21-preview2

Sohbet yazışması alır.

GET {endpoint}/chat/threads/{chatThreadId}?api-version=2020-09-21-preview2

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
chatThreadId	path	True	string	Alınacak iş parçacığı kimliği.
endpoint	path	True	string	Azure İletişim kaynağının uç noktası.
api-version	query	True	string	Çağrılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
Authorization	True	string	ACS (Azure İletişim Hizmetleri) kullanıcı erişim belirteci.

Yanıtlar

Name	Tür	Description
200 OK	ChatThread	İstek başarılı oldu. Eylem bir `Thread` kaynağı döndürür.
401 Unauthorized	Error	Yetkisiz
403 Forbidden	Error	Yasak
429 Too Many Requests	Error	Çok fazla istek var
Other Status Codes	Error	Hizmet kullanılamıyor

Güvenlik

Authorization

ACS (Azure İletişim Hizmetleri) kullanıcı erişim belirteci.

Tür: apiKey
İçinde: header

Örnekler

Get chat thread

Örnek isteği

HTTP

GET https://contoso.westus.communications.azure.com/chat/threads/19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2?api-version=2020-09-21-preview2

Örnek yanıt

Durum kodu:: 200

{
  "id": "19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2",
  "topic": "Lunch",
  "createdOn": "2020-06-06T05:55:41.6460000Z",
  "createdBy": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
  "members": [
    {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10a",
      "shareHistoryTime": "2020-06-06T05:55:41Z"
    },
    {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
      "shareHistoryTime": "2020-06-06T05:55:41Z"
    }
  ]
}

Durum kodu:: 401

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

Durum kodu:: 403

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

Durum kodu:: 429

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

Durum kodu:: 503

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

Tanımlar

Name	Description
ChatThread
ChatThreadMember	Sohbet yazışmasının bir üyesi.
Error

ChatThread

Object

Name	Tür	Description
createdBy	string	Sohbet yazışması sahibinin kimliği.
createdOn	string (date-time)	Sohbet yazışmasının oluşturulduğu zaman damgası. Zaman damgası ISO8601 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.
id	string	Sohbet yazışması kimliği.
members	ChatThreadMember[]	Sohbet yazışması üyeleri.
topic	string	Sohbet yazışması konusu.

ChatThreadMember

Object

Sohbet yazışmasının bir üyesi.

Name	Tür	Description
displayName	string	Sohbet yazışması üyesinin görünen adı.
id	string	sohbet yazışması üyesinin `8:acs:ResourceId_AcsUserId`biçimindeki kimliği.
shareHistoryTime	string (date-time)	Sohbet geçmişinin üyeyle paylaşıldığı zaman. Zaman damgası ISO8601 biçimdedir: `yyyy-MM-ddTHH:mm:ssZ`.

Error

Object

Name	Tür	Description
code	string
innerErrors	Error[]
message	string
target	string