Chat Thread - Upload Chat Image

Layanan:

Communication

Versi API:

2025-11-15-preview

Unggah gambar di utas, atas nama pengguna.

POST {endpoint}/chat/threads/{chatThreadId}/images?api-version=2025-11-15-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
chatThreadId	path	True	string	Id utas tempat gambar yang diunggah berada. (Rapat Teams saja)
endpoint	path	True	string	Titik akhir sumber daya Azure Communication.
api-version	query	True	string	Versi API yang akan dipanggil.

Header Permintaan

Media Types: "application/octet-stream"

Nama	Diperlukan	Jenis	Deskripsi
Authorization	True	string	Token akses pengguna ACS (Azure Communication Services).
image-filename		string	Nama file gambar.

Isi Permintaan

Media Types: "application/octet-stream"

Nama	Jenis	Deskripsi
chatImageFile	string (binary)	Data biner gambar, format gambar yang diizinkan: jpeg, png, gif, heic, webp

Respons

Nama	Jenis	Deskripsi
201 Created	UploadChatImageResult	Berhasil diunggah, header Location berisi URL untuk gambar yang baru diunggah.
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

Authorization

Token akses pengguna ACS (Azure Communication Services).

Jenis: apiKey
Dalam: header

Contoh

Upload Image

Permintaan sampel

HTTP

POST https://contoso.westus.communications.azure.com/chat/threads/19:34adfa4f-cedf-4dc0-ba29-b6d1a69ab345@thread.v2/images?api-version=2025-11-15-preview


"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAAAAAA6fptVAAAACklEQVQYV2P4DwABAQEAWk1v8QAAAABJRU5ErkJggg=="

Respon sampel

Kode status:

201

Location: /chat/threads/19:34adfa4f-cedf-4dc0-ba29-b6d1a69ab345@thread.v2/images/0-eus-d2-fb42e272282ebb6ef76a3aedd1974433

{
  "id": "0-eus-d2-fb42e272282ebb6ef76a3aedd1974433",
  "attachmentType": "inlineImage",
  "name": "sample.png"
}

Definisi

Nama	Deskripsi
ChatAttachmentType	Jenis lampiran.
Error	Informasi respons kesalahan.
ErrorDetail	Informasi detail kesalahan.
ErrorResponse	Pembungkus untuk respons kesalahan untuk mengikuti panduan ARM.
UploadChatImageResult	Payload hasil untuk mengunggah gambar.

ChatAttachmentType

Enumeration

Jenis lampiran.

Nilai	Deskripsi
image
file

Error

Objek

Informasi respons kesalahan.

Nama	Jenis	Deskripsi
code	string	Error code.
details	ErrorDetail[]	Array objek detail kesalahan.
message	string	Error message.

ErrorDetail

Objek

Informasi detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Error code.
message	string	Error message.

ErrorResponse

Objek

Pembungkus untuk respons kesalahan untuk mengikuti panduan ARM.

Nama	Jenis	Deskripsi
error	Error	Respons kesalahan.

UploadChatImageResult

Objek

Payload hasil untuk mengunggah gambar.

Nama	Jenis	Deskripsi
attachmentType	ChatAttachmentType	Jenis lampiran.
id	string	Id gambar yang dihasilkan server.
name	string	Nama termasuk jenis ekstensi file lampiran.