Chat Thread - Send Chat Read Receipt

Usługa:

Communication

Wersja interfejsu API:

2024-03-07

Wysyła zdarzenie potwierdzenia odczytu do wątku w imieniu użytkownika.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
chatThreadId	path	True	string	Identyfikator wątku do wysłania zdarzenia potwierdzenia odczytu do.
endpoint	path	True	string	Punkt końcowy zasobu usługi Azure Communication.
api-version	query	True	string	Wersja interfejsu API do wywołania.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Authorization	True	string	Token dostępu użytkownika usług ACS (Azure Communication Services).

Treść żądania

Nazwa	Wymagane	Typ	Opis
chatMessageId	True	string	Identyfikator najnowszej wiadomości czatu odczytanej przez użytkownika.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Żądanie powiodło się.
401 Unauthorized	CommunicationErrorResponse	Nieautoryzowanych.
403 Forbidden	CommunicationErrorResponse	Zakazany.
429 Too Many Requests	CommunicationErrorResponse	Zbyt wiele żądań.
Other Status Codes	CommunicationErrorResponse	Usługa jest niedostępna.

Zabezpieczenia

Authorization

Token dostępu użytkownika usług ACS (Azure Communication Services).

Typ: apiKey
W: header

Przykłady

Send read receipt

Przykładowe żądanie

HTTP

POST https://contoso.westus.communications.azure.com/chat/threads/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/readReceipts?api-version=2024-03-07

{
  "chatMessageId": "1591137790240"
}

Przykładowa odpowiedź

Kod stanu:

200

Kod stanu:

401

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

Kod stanu:

403

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

Kod stanu:

429

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

Kod stanu:

503

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

Definicje

SendReadReceiptRequest

Żądanie ładunku na potrzeby wysyłania potwierdzenia odczytu.

Nazwa	Typ	Opis
chatMessageId	string	Identyfikator najnowszej wiadomości czatu odczytanej przez użytkownika.