API

Getting a list of dialogs

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/chats?token={token}
Method:	GET
Request headers:	Accept: application/json
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: View method to get access token filter_new unread message filter 0 — all dialogs; 1 — dialogs with unread messages only. Default value is 0. email buyer email filter id_ds filter by product id separator — comma. Example: id_ds=1,2,3 pagesize page size maximum value is 200. Default value is 20 page page number default value is 1
Response format:	{ "cnt_pages": 5, "items": [ { "id_i": 129647692, "email": "user@example.com", "product": "digital product", "last_date": "2022-02-10 20:37:19", "cnt_msg": 16, "cnt_new": 3 }, ... ] }
Response parameters:	Name Use Comment cnt_pages the number of pages items array of dialogs items\id_i order number items\email buyer's email items\product product name items\last_date date and time of the last message items\cnt_msg number of messages items\cnt_new number of unread messages

Getting dialog status

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/chat-state?token={token}&id_i={id_i}
Method:	GET
Request headers:	Accept: application/json
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: View method to get access token id_i order number
Response format:	{ "chat_state": 1, "may_change": 0, }
Response parameters:	Name Use Comment chat_state dialog status 0 — the dialog is closed; 1 — the dialog is open by the seller; 2 — the dialog is open by the admin. may_change permission to change the status of the dialog 0 — not allowed; 1 — allowed.

Changing the status of a dialog

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/chat-state?token={token}&id_i={id_i}&chat_state={chat_state}
Method:	POST
Request headers:	Accept: application/json Content-Type: application/json
Request format:	empty
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: Send method to get access token id_i order number chat_state dialog status 0 — open; 1 — close. * closing the dialog is not possible if it was opened by the admin. * closing the dialogue is not possible with an open dispute with negative feedback.
Response format:	empty * empty response with HTTP status code 200 means success.

Getting a list of messages

The URL for sending a request:	https://api.digiseller.com/api/debates/v2?token={token}&id_i={id_i}
Method:	GET
Request headers:	Accept: application/json
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: View method to get access token id_i order number hidden return deleted messages 0 | 1 id_from message ID starting from which to get id_to message ID up to which to receive (inclusive) old_id message ID that has already been received ignored if id_from and id_to are given newer return all unreceived messages 0 | 1. Ignored if id_from and id_to are given. count how many messages to return maximum value is 200. Default value is 20. Ignored if id_from and id_to, or newer are given.
Response format:	[ { "id": 56627081, "message": "screenshot.png", "buyer": 1, "seller": 0, "deleted": 0, "date_written": "2022-01-25 10:37:13", "date_seen": "2022-01-25 10:37:20", "is_file": 1, "filename": "screenshot.png", "url": "https://my.digiseller.com/attach/129647692/56627081/image.png", "is_img": 1, "preview": "https://graph.digiseller.ru/img_deb.ashx?f=129647692/56627081/image.png&w=200" }, ... ]
Response parameters:	Name Use Comment id message_id message message_text buyer a sign that the message is from the buyer 0 | 1 seller a sign that the message is from the seller 0 | 1 deleted deleted 0 | 1 date_written date and time the message was sent date_seen date and time the message was read is_file indication that the message is a file 0 | 1 filename original filename url file URL is_img sign that the message is an image 0 | 1 preview Image thumbnail URL * all fields, except for ID and Message, may be missing in the response. * after receiving all messages of the dialog, you need to call the "Setting the read flag" method.

Setting the read flag

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/seen?token={token}&id_i={id_i}
Method:	POST
Request headers:	Accept: application/json Content-Type: application/json
Request format:	empty
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: View method to get access token id_i order number
Response format:	empty * empty response with HTTP status code 200 means success.

Preuploading files

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/upload-preview?token={token}&lang={lang}
Request headers:	Accept: application/json Content-Type: multipart/form-data
Method:	POST
Request format:	"files[]": binary data
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: Send method to get access token lang the information display language ru-RU (by default) or en-US
Response format:	{ "files": [ { "newid": "", "name": "", "type": "", "size": 10, "message": "", "error": "", "error_num": 0 }, ... ] }
Response parameters:	Name Use Comment files array of uploaded files files\newid uploaded file ID string files\name file name files\type file type files\size file size files\message file upload success message files\error file upload error message files\error_num file upload error code 0 — success; otherwise failure. * to send preloaded files, you must call the method to send a new message.

Sending a new message

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/?token={token}&id_i={id_i}
Method:	POST
Request headers:	Accept: application/json Content-Type: application/json
Request format:	{ "message": "", "files": [ { "newid": "", "name": "", "type": "" }, ... ] }
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: Send method to get access token id_i order number message message_text files array of uploaded files obtained from the file preupload method files\newid uploaded file ID files\name file name files\type file type
Response format:	empty * empty response with HTTP status code 200 means success.

Deleting a message

The URL for sending a request:	https://api.digiseller.com/api/debates/v2/{id}?token={token}&id_i={id_i}
Method:	DELETE
Request headers:	Accept: application/json
Request parameters:	Name Use Comment token access token, min. permission: [ Correspondence with buyers ]: Delete method to get access token id_i order number id message_id
Response format:	[]
Response parameters:	* an empty array in the response means success.