Megosztás a következőn keresztül:


Chat Thread - List Chat Read Receipts

Lekéri a csevegőüzenetek olvasási visszaigazolásait egy szálhoz.

GET {endpoint}/chat/threads/{chatThreadId}/readReceipts?api-version=2025-03-15
GET {endpoint}/chat/threads/{chatThreadId}/readReceipts?maxPageSize={maxPageSize}&skip={skip}&api-version=2025-03-15

URI-paraméterek

Name In Kötelező Típus Description
chatThreadId
path True

string

Szálazonosító a csevegőüzenet olvasási nyugtáinak lekéréséhez.

endpoint
path True

string

Az Azure Communication-erőforrás végpontja.

api-version
query True

string

A meghívandó API verziója.

maxPageSize
query

integer (int32)

A csevegőüzenetek olvasási nyugtáinak maximális száma az oldalonként.

skip
query

integer (int32)

A csevegőüzenet olvasási visszaigazolásainak kihagyása egy adott válaszpozícióig.

Kérelem fejléce

Name Kötelező Típus Description
Authorization True

string

ACS (Azure Communication Services) felhasználói hozzáférési jogkivonat.

Válaszok

Name Típus Description
200 OK

ChatMessageReadReceiptsCollection

A kérés sikeres. A művelet a kért ChatMessageReadReceipt erőforrásokat adja vissza.

401 Unauthorized

CommunicationErrorResponse

Illetéktelen.

403 Forbidden

CommunicationErrorResponse

Tiltott.

429 Too Many Requests

CommunicationErrorResponse

Túl sok kérés.

Other Status Codes

CommunicationErrorResponse

A szolgáltatás nem érhető el.

Biztonság

Authorization

ACS (Azure Communication Services) felhasználói hozzáférési jogkivonat.

Típus: apiKey
In: header

Példák

Get thread read receipts with pagination (max page size)

Mintakérelem

GET https://contoso.westus.communications.azure.com/chat/threads/19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2/readReceipts?maxPageSize=2&api-version=2025-03-15

Mintaválasz

{
  "value": [
    {
      "senderCommunicationIdentifier": {
        "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"
        }
      },
      "chatMessageId": "1591137790240",
      "readOn": "2020-06-06T05:55:41.6460000Z"
    },
    {
      "senderCommunicationIdentifier": {
        "rawId": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_c94ff260-162d-46d6-94fd-e79f4d213715",
        "communicationUser": {
          "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_c94ff260-162d-46d6-94fd-e79f4d213715"
        }
      },
      "chatMessageId": "1591768249318",
      "readOn": "2020-06-06T05:55:41.6460000Z"
    }
  ],
  "nextLink": "https://contoso.westus.communications.azure.com/chat/threads/19:453dafb77b26481ea2e73bcada0324af@thread.v2/readReceipts?skip=2&maxPageSize=2&api-version=2025-03-15"
}
{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized."
  }
}
{
  "error": {
    "code": "Forbidden",
    "message": "User is not allowed to perform specified action."
  }
}
{
  "error": {
    "code": "TooManyRequests",
    "message": "Rate limit exceeded."
  }
}
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "The server is currently unable to handle the request."
  }
}

Definíciók

Name Description
ChatMessageReadReceipt

A csevegőüzenet olvasási visszaigazolása azt jelzi, hogy a címzett mikor olvasta fel a csevegőüzenetet.

ChatMessageReadReceiptsCollection

A csevegőüzenetek olvasási visszaigazolásainak lapozott gyűjteménye.

ChatMessageReadReceipt

A csevegőüzenet olvasási visszaigazolása azt jelzi, hogy a címzett mikor olvasta fel a csevegőüzenetet.

Name Típus Description
chatMessageId

string

Az olvasott csevegőüzenet azonosítója. Ezt az azonosítót a kiszolgáló hozza létre.

readOn

string (date-time)

Az üzenet olvasásának időpontja. Az időbélyeg RFC3339 formátumban van: yyyy-MM-ddTHH:mm:ssZ.

senderCommunicationIdentifier

CommunicationIdentifierModel

ChatMessageReadReceiptsCollection

A csevegőüzenetek olvasási visszaigazolásainak lapozott gyűjteménye.

Name Típus Description
nextLink

string

Ha több csevegőüzenet olvasási visszaigazolása kérhető le, a következő hivatkozás fel lesz töltve.

value

ChatMessageReadReceipt[]

A csevegőüzenetek olvasási visszaigazolásainak gyűjteménye.