Digiseller Inside API

https://my.digiseller.com/inside/api
Admin
Digiseller Inside API is a REST API that enables developers to access and manage digital products,...
Tokens:108,377
Snippets:249
Trust Score:9.4
Update:10 months ago
Show doc for...
Tokens:
Raw
### Example API Request for Price Calculation

Source: https://my.digiseller.com/inside/api/_catgoods

This example illustrates a GET request to the Digiseller API for calculating a product's price. It demonstrates how to include product ID, specific options, desired currency, and quantity in the URL parameters.

```http
GET https://api.digiseller.com/api/products/price/calc?product_id=12345&options[]=28532:41541&options[]=28530:41534&currency=WMZ&unit_cnt=5 HTTP/1.1
Accept: application/json
```

--------------------------------

### XML Response Format Example

Source: https://my.digiseller.com/inside/api/_goods

Example of an XML response from the API, indicating a successful operation. This format is used for returning results and status information.

```xml
<response>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors/>
  <content>
    <status>Success</status>
  </content>
</response>
```

--------------------------------

### JSON Response Format Example

Source: https://my.digiseller.com/inside/api/_goods

Example of a JSON response from the API, indicating a successful operation. This format is used for returning results and status information.

```json
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "status": "Success"
  }
}
```

--------------------------------

### Delete All Content for a Product - GET Request Example

Source: https://my.digiseller.com/inside/api/_content

This example demonstrates how to completely remove all content associated with a specific product. The request is a GET method and requires the `product_id` and a valid access token. A successful request returns a 200 status code and a JSON response indicating the number of deleted content items.

```http
GET /api/product/content/delete/all?productid={product_id}&token={token} HTTP/1.1
Host: api.digiseller.com
Content-Type: application/json
```

--------------------------------

### GET /api/products/list

Source: https://my.digiseller.com/inside/api/_catgoods

Retrieve product details for a given list of product IDs. Supports specifying the language for the returned information.

```APIDOC
## GET /api/products/list

### Description
This endpoint allows you to quickly get product descriptions and other details from a list of product IDs.

### Method
GET

### Endpoint
https://api.digiseller.com/api/products/list

### Parameters
#### Query Parameters
- **ids** (integer) - Required - A comma-separated list of product IDs. Maximum 2000 IDs.
- **lang** (string) - Optional - The language for the product information. Defaults to 'ru-RU'. Accepts 'en-US' for English.
- **token** (string) - Optional - An authentication token. If provided and belongs to the product owner, hidden sales and stock data will be revealed.

### Request Example
```json
{
  "ids": [123, 456, 789],
  "lang": "en-US",
  "token": "your_api_token"
}
```

### Response
#### Success Response (200)
- **id** (integer) - Product ID.
- **id_seller** (integer) - Seller ID.
- **name** (string) - Product name.
- **info** (string) - Product description.
- **add_info** (string) - Additional information about the product.
- **collection** (string) - Product content type (e.g., 'digi', 'pins', 'unit', 'book', 'soft').
- **base_currency** (string) - The base currency set by the seller.
- **base_price** (float) - The price in the base currency.
- **price_usd** (float) - Price in USD.
- **price_rub** (float) - Price in RUB.
- **price_eur** (float) - Price in EUR.
- **price_uah** (float) - Price in UAH.
- **cnt_sell** (integer) - Number of sales. -1 means completely hidden.
- **cnt_sell_hidden** (integer) - Display mode of sales number (0: visible, 1: hidden).
- **cnt_return** (integer) - Number of refunds. -1 means completely hidden.
- **cnt_return_hidden** (integer) - Refunds number display mode (0: visible, 1: hidden).
- **in_stock** (integer) - Product availability (0: out of stock, 1: in stock).
- **num_in_stock** (integer) - Quantity available for purchase.
- **num_in_lock** (integer) - Number of items reserved for payment.
- **owner_id** (integer) - Marketplace code.
- **release_date** (string) - Release date.
- **sale_info** (object) - Sale information.
  - **common_base_price** (float) - Base price before sale.
  - **common_price_usd** (float) - Price before sale in USD.
  - **common_price_rur** (float) - Price before sale in RUR.
  - **common_price_eur** (float) - Price before sale in EUR.
  - **common_price_uah** (float) - Price before sale in UAH.
  - **sale_begin** (string) - Sale start date.
  - **sale_end** (string) - Sale expiration date.
  - **sale_percent** (float) - Discount percentage.

#### Response Example
```json
[
  {
    "id": 0,
    "id_seller": 0,
    "name": "Example Product Name",
    "info": "This is a detailed description of the example product.",
    "add_info": "Additional details here.",
    "collection": "unit",
    "base_currency": "USD",
    "base_price": 10.00,
    "price_usd": 10.00,
    "price_rub": 750.00,
    "price_eur": 9.00,
    "price_uah": 390.00,
    "cnt_sell": 150,
    "cnt_sell_hidden": 0,
    "cnt_return": 5,
    "cnt_return_hidden": 0,
    "in_stock": 1,
    "num_in_stock": 100,
    "num_in_lock": 0,
    "owner_id": 12345,
    "release_date": null,
    "sale_info": {
      "common_base_price": 12.00,
      "common_price_usd": 12.00,
      "common_price_rur": 900.00,
      "common_price_eur": 10.80,
      "common_price_uah": 468.00,
      "sale_begin": "30.12.2020 13:00:00",
      "sale_end": "31.12.2020 20:00:00",
      "sale_percent": 16.67
    }
  }
]
```
```

--------------------------------

### Product Discount API

Source: https://my.digiseller.com/inside/api/_catgoods

This API endpoint allows you to get a product discount by providing the product ID, currency, and customer's email.

```APIDOC
## POST /xml/shop_discount.asp

### Description
Retrieves product discount information based on product ID, currency, and customer email.

### Method
POST

### Endpoint
http://shop.digiseller.ru/xml/shop_discount.asp

### Parameters
#### Request Body
- **product[id]** (integer) - Required - Item ID.
- **product[currency]** (string) - Required - Currency type (USD, RUR, EUR, UAH, or mBTC).
- **email** (string) - Required - Customer's email address.

### Request Example
```json
{
  "product": {
    "id": "12345",
    "currency": "USD"
  },
  "email": "customer@example.com"
}
```

### Response
#### Success Response (0)
- **retval** (integer) - Result code (0 indicates request sent).
- **retdesc** (string) - Decryption of the request execution code.
- **product[price]** (number) - The discounted price in the specified WM currency.
- **discount[percent]** (number) - Discount percentage.
- **discount[total]** (number) - The total cost of purchases (always in USD).
- **discount[currency]** (string) - Currency type (always in USD).

#### Response Example
```json
{
  "retval": 0,
  "retdesc": "Request sent successfully.",
  "product": {
    "price": 90.00
  },
  "discount": {
    "percent": 10,
    "total": 90.00,
    "currency": "USD"
  }
}
```
```

--------------------------------

### Calculate Product Price - JSON

Source: https://my.digiseller.com/inside/api/_catgoods

This snippet demonstrates how to calculate the price of a product by sending a GET request to the product price calculation endpoint. It includes parameters for product ID, options, currency, and quantity. The response provides detailed pricing information.

```json
{
  "retval": 0,
  "retdesc": "",
  "data": {
    "price": 100.00,
    "count": 1,
    "amount": 100.00,
    "currency": "USD",
    "commission": 5.00,
    "sale_info": {
      "common_base_price": 120.00,
      "sale_percent": 16
    }
  }
}
```

--------------------------------

### Delete Specific Content Item - GET Request Example

Source: https://my.digiseller.com/inside/api/_content

This example illustrates how to send a GET request to delete a specific content item (text, URL, or file). The request requires the `content_id` and `product_id` of the item to be deleted, along with an access token. A successful deletion returns a 200 status code with no content.

```http
GET /api/product/content/delete?contentid={content_id}&productid={product_id}&token={token} HTTP/1.1
Host: api.digiseller.com
Content-Type: application/json
```

--------------------------------

### Product Options and Parameters

Source: https://my.digiseller.com/inside/api/_general

This section covers product options, which are applicable for products with additional parameters. It details how to access individual option parameters, their identifiers, names, and user-provided data.

```APIDOC
## GET /websites/my_digiseller_inside_api/content/options

### Description
Retrieves the list of options for products that have additional parameters.

### Method
GET

### Endpoint
/websites/my_digiseller_inside_api/content/options

### Parameters
#### Query Parameters
- **content.options** - Optional - Represents the list of parameters for products with additional options.
  - **content.options.option** - Represents an individual parameter chosen or specified by the customer.
    - **content.options.option.id** (integer) - Unique identifier for the parameter.
    - **content.options.option.name** (string) - The name of the parameter.
    - **content.options.option.user_data** (string) - The value chosen or specified by the customer for the parameter.
    - **content.options.option.user_data_id** (integer) - The variant ID according to the buyer's choice. Can be null for 'radio' or 'select' type fields.

### Response
#### Success Response (200)
- **content.options** (array) - A list of product options.
  - Each option object contains:
    - **id** (integer) - Unique parameter identifier.
    - **name** (string) - Parameter name.
    - **user_data** (string) - Parameter value chosen or specified by the customer.
    - **user_data_id** (integer | null) - Parameter variant ID, according to buyer's choice.

#### Response Example
```json
{
  "content": {
    "options": [
      {
        "id": 101,
        "name": "Color",
        "user_data": "Blue",
        "user_data_id": 5
      },
      {
        "id": 102,
        "name": "Size",
        "user_data": "XL",
        "user_data_id": null
      }
    ]
  }
}
```
```

--------------------------------

### Preview Images and Videos API

Source: https://my.digiseller.com/inside/api/_catgoods

Manage and retrieve parameters for product thumbnail images and preview videos.

```APIDOC
## GET /websites/my_digiseller_inside_api/product/preview_imgs

### Description
Retrieves thumbnail image parameters for a product.

### Method
GET

### Endpoint
/websites/my_digiseller_inside_api/product/preview_imgs

### Query Parameters
- **product.preview_imgs.cnt** (integer) - Optional - The number of images.
- **product.preview_imgs.id** (string) - Optional - The ID of the image.
- **product.preview_imgs.url** (string) - Optional - The URL of the image.
- **product.preview_imgs.width** (integer) - Optional - The width of the image in pixels.
- **product.preview_imgs.height** (integer) - Optional - The height of the image in pixels.

### Response
#### Success Response (200)
- **product.preview_imgs** (array) - List of preview images.
  - **id** (string) - The ID of the image.
  - **url** (string) - The URL of the image.
  - **width** (integer) - The width of the image in pixels.
  - **height** (integer) - The height of the image in pixels.

#### Response Example
```json
{
  "product.preview_imgs": [
    {
      "id": "img123",
      "url": "http://example.com/image.jpg",
      "width": 200,
      "height": 150
    }
  ]
}
```

## GET /websites/my_digiseller_inside_api/product/preview_videos

### Description
Retrieves preview video parameters for a product.

### Method
GET

### Endpoint
/websites/my_digiseller_inside_api/product/preview_videos

### Query Parameters
- **product.preview_videos.type** (string) - Optional - The type of the video (e.g., 'youtube', 'vimeo').
- **product.preview_videos.id** (string) - Optional - The ID of the video.
- **product.preview_videos.preview** (string) - Optional - The URL of the video preview image.

### Response
#### Success Response (200)
- **product.preview_videos** (array) - List of preview videos.
  - **type** (string) - The type of the video.
  - **id** (string) - The ID of the video.
  - **preview** (string) - The URL of the video preview image.

#### Response Example
```json
{
  "product.preview_videos": [
    {
      "type": "youtube",
      "id": "dQw4w9WgXcQ",
      "preview": "http://example.com/video_preview.jpg"
    }
  ]
}
```
```

--------------------------------

### GET /api/agents/offer

Source: https://my.digiseller.com/inside/api/_catgoods

Fetches a list of goods for a seller, including optional filters for stock status, individual commissions, product name, and product ID. Requires an access token.

```APIDOC
## GET /api/agents/offer

### Description
Retrieves a list of goods a seller is offering. Supports filtering by stock status, individual commission status, product name, and product ID. Pagination is also supported.

### Method
GET

### Endpoint
https://api.digiseller.com/api/agents/offer

### Parameters
#### Query Parameters
- **sellerId** (Integer) - Required - The unique identifier of the seller.
- **onlyInStock** (Boolean) - Optional - Defaults to `false`. If `true`, only products currently in stock are returned.
- **onlyIndividual** (Boolean) - Optional - Defaults to `false`. If `true`, only products with individual commissions are returned.
- **productName** (String) - Optional - Filters products by name. Case-insensitive.
- **productId** (Integer) - Optional - Filters products by their unique identifier.
- **page** (Integer) - Required - The page number for pagination.
- **count** (Integer) - Required - The number of items to return per page. Must be between 1 and 100.
- **token** (String) - Required - The access token for authentication. Minimum permission required: 'Affiliate program - Individual offer'.

### Request Example
```json
{
  "sellerId": 12345,
  "onlyInStock": true,
  "productName": "Example Product",
  "page": 1,
  "count": 20,
  "token": "your_access_token_here"
}
```

### Response
#### Success Response (200)
- **retval** (Integer) - Result code. `0` indicates success.
- **retdesc** (String|null) - Description of the result code. `null` on success.
- **errors** (Array|null) - An array of errors if the request failed. `null` on success.
- **content** (Object) - Contains the response data if the request was successful.
  - **page** (Integer) - The current page number.
  - **count** (Integer) - The number of items returned on this page.
  - **has_next_page** (Boolean) - Indicates if there is a next page of results.
  - **has_previous_page** (Boolean) - Indicates if there is a previous page of results.
  - **total_count** (Integer) - The total number of items available across all pages.
  - **total_pages** (Integer) - The total number of pages.
  - **items** (Array) - An array of product objects.
    - **product_id** (Integer) - The unique identifier of the product.
    - **name** (Array) - An array of name objects, each with a `locale` (String) and `value` (String).
    - **price** (Float) - The price of the product.
    - **currency** (String) - The currency of the price (e.g., "USD", "EUR").
    - **in_affiliate** (Boolean) - Indicates if the product is part of an affiliate program.
    - **global_percent** (Integer) - The global commission percentage set for the product.
    - **individual_percent** (Integer) - The individual commission percentage for the seller.
    - **last_change** (String|null) - The date and time of the last change in ISO 8601 format, or `null` if not applicable.

#### Error Response (400 or other)
- **retval** (Integer) - Result code. `1` indicates an error.
- **retdesc** (String|null) - A general description of the error.
- **errors** (Array) - An array of error objects, each containing:
  - **code** (String) - The error code.
  - **message** (String) - A description of the error.
- **content** (null) - This field will be `null` in case of errors.

#### Response Example (Success)
```json
{
  "retval": 0,
  "retdesc": null,
  "errors": null,
  "content": {
    "page": 1,
    "count": 11,
    "has_next_page": true,
    "has_previous_page": false,
    "total_count": 42,
    "total_pages": 4,
    "items": [
      {
        "product_id": 1,
        "name": [
          { "locale": "ru-RU", "value": "Sample name RU" },
          { "locale": "en-US", "value": "Sample name EN" }
        ],
        "price": 0.04,
        "currency": "USD",
        "in_affiliate": true,
        "global_percent": 0,
        "individual_percent": 13,
        "last_change": null
      }
    ]
  }
}
```
```

--------------------------------

### Get Sales Information (JSON) - Digiseller API

Source: https://my.digiseller.com/inside/api/_general

This snippet demonstrates how to make a GET request to the Digiseller API to retrieve sales information for a given order number. It requires an invoice_id and an access token. The response will be in JSON format.

```bash
curl -X GET "https://api.digiseller.com/api/purchase/info/{invoice_id}?token={token}" \
     -H "Accept: application/json"
```

--------------------------------

### Partner Registration - Step 2: Verify Captcha and Register Partner

Source: https://my.digiseller.com/inside/api/_general

This endpoint verifies the provided captcha code and completes the partner registration process.

```APIDOC
## GET /xml/agent_check.asp

### Description
Verifies the captcha code and completes the partner registration. Sends a confirmation email to the partner.

### Method
GET

### Endpoint
`//shop.digiseller.ru/xml/agent_check.asp`

### Parameters
#### Query Parameters
- **id_seller** (string) - Required - Your seller ID.
- **id_request** (string) - Required - The request number obtained from the previous step.
- **turing_num** (string) - Required - The verification number entered by the partner (captcha code).
- **r_email** (string) - Required - The partner's email address.
- **r_redirect_url** (string) - Required - The URL to redirect newly registered partners after email verification.

### Request Example
```
GET //shop.digiseller.ru/xml/agent_check.asp?id_seller=YOUR_SELLER_ID&id_request=REQUEST_NUMBER&turing_num=CAPTCHA_CODE&r_email=partner@example.com&r_redirect_url=http://www.yoursite.com/welcome
```

### Response
#### Success Response (200)
- **retval** (string) - Result code. '0' indicates success. Other codes indicate various errors.
- **retdesc** (string) - Error description if retval is not '0'.
- **id_seller** (string) - Your seller ID.
- **id_request** (string) - The request number.
- **id_agent** (string) - '0' if registration is pending, or the partner's ID if registration is complete.

#### Response Example
```json
{
  "retval": "0",
  "retdesc": "",
  "id_seller": "1",
  "id_request": "993817",
  "id_agent": "0"
}
```
```

--------------------------------

### Digiseller API Response - Success Example

Source: https://my.digiseller.com/inside/api/_content

Example of a successful response from the Digiseller API after creating or updating form content. The 'retval' field indicates success (0), and the 'content' object contains the status of the operation.

```json
{
  "retval": 0,
  "retdesc": null,
  "errors": null,
  "content": {
    "status": "Success"
  }
}
```

--------------------------------

### Product File Details API

Source: https://my.digiseller.com/inside/api/_catgoods

Retrieves specific details for products of type 'file', including publishing date, size, name, and trial version URL.

```APIDOC
## GET /websites/my_digiseller_inside_api/product/file

### Description
Retrieves options for products of type 'file'.

### Method
GET

### Endpoint
/websites/my_digiseller_inside_api/product/file

### Response
#### Success Response (200)
- **date** (string) - The date of publishing in 'DD.MM.YYYY h:mm:ss' format.
- **size** (integer) - The file size in bytes.
- **name** (string) - The file name.
- **trial** (string) - The URL of the trial version of the product.

#### Response Example
```json
{
  "date": "25.10.2023 14:30:00",
  "size": 1048576,
  "name": "product_file.zip",
  "trial": "https://example.com/trial/product_file.zip"
}
```
```

--------------------------------

### Digiseller API Response - XML Success Example

Source: https://my.digiseller.com/inside/api/_content

Example of a successful XML response from the Digiseller API after creating or updating form content. It includes a 'retval' of 0 for success and nested elements indicating the content status.

```xml
<root>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors></errors>
  <content>
    <status>Success</status>
  </content>
</root>
```

--------------------------------

### Example JSON Response for Adding File

Source: https://my.digiseller.com/inside/api/_content

Example JSON response after successfully adding a file. It includes a result code (retval), description (retdesc), null errors, and a content array with the new content ID and filename.

```JSON
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": [
    {
      "content_id": 6403229,
      "filename": "New Text Document.txt"
    }
  ]
}
```

--------------------------------

### Delete Product Parameter (GET Request)

Source: https://my.digiseller.com/inside/api/_parameters

Removes a product parameter using its ID via a GET request. Requires an access token with delete permissions for parameters. The response indicates success or failure.

```http
GET https://api.digiseller.com/api/products/options/{option_id}/delete?token={token} HTTP/1.1
Host: api.digiseller.com
Accept: application/json
```

--------------------------------

### Example XML Response Format

Source: https://my.digiseller.com/inside/api/_goods

This demonstrates the structure of a successful XML response from the API. It includes a result code, description, an empty errors element, and content with a status element.

```xml
<response>
  <retval>0</retval>
  <retdesc></retdesc>
  <errors></errors>
  <content>
    <status>Success</status>
  </content>
</response>
```

--------------------------------

### Get Sales Information (XML) - Digiseller API

Source: https://my.digiseller.com/inside/api/_general

This snippet shows how to request sales details from the Digiseller API using an order number. It specifies the endpoint, the GET method, and requests the response in XML format. An access token and the invoice_id are mandatory parameters.

```bash
curl -X GET "https://api.digiseller.com/api/purchase/info/{invoice_id}?token={token}" \
     -H "Accept: text/xml"
```

--------------------------------

### Product Options and Visibility

Source: https://my.digiseller.com/inside/api/_catgoods

Endpoints related to product options, their visibility, and checks before payment.

```APIDOC
## GET /product/options/option/variants/variant/visible

### Description
Controls the visibility of a product variant.

### Method
GET

### Endpoint
`/product/options/option/variants/variant/visible`

### Parameters
#### Query Parameters
- **visibility** (integer) - Required - `1` for not hidden, otherwise hidden.

### Request Example
```json
{
  "example": "GET /product/options/option/variants/variant/visible?visibility=1"
}
```

### Response
#### Success Response (200)
- **message** (string) - Indicates the success of the operation.

#### Response Example
```json
{
  "example": "Visibility updated successfully."
}
```

## GET /product/options_check

### Description
Indicates if the option 'before paying, send the parameters to my server to be checked' is enabled for a product.

### Method
GET

### Endpoint
`/product/options_check`

### Parameters
#### Query Parameters
- **indicator** (integer) - Required - `0` or `1` to indicate the status.

### Request Example
```json
{
  "example": "GET /product/options_check?indicator=1"
}
```

### Response
#### Success Response (200)
- **message** (string) - Indicates the success of the operation.

#### Response Example
```json
{
  "example": "Option check status updated."
}
```
```

--------------------------------

### Get Permission List via Token

Source: https://my.digiseller.com/inside/api/_general

This snippet shows how to retrieve the list of permissions associated with an API token using a GET request to https://api.digiseller.com/api/token/perms. The token is passed as a URL parameter. The response is a JSON array of strings representing available permissions.

```json
[
  "token_get_perms",
  "description_create",
  "description_edit"
]
```

--------------------------------

### Preliminary Parameter Check API (XML)

Source: https://my.digiseller.com/inside/api/_payment

This snippet demonstrates the XML request format for performing a preliminary check of product parameters before purchase. It includes product details and a list of options with their corresponding values. The response indicates success or failure with an error message.

```xml
<request>
  <product>
    <id>0</id>
    <cnt>0.0</cnt>
    <lang>ru-RU</lang>
  </product>
  <options>
    <option id="0" type="text">
      <value>text</value>
    </option>
    <option id="0" type="textarea">
      <value>textarea</value>
    </option>
    <option id="0" type="select">
      <value>0</value>
    </option>
    <option id="0" type="checkbox">
      <value>0</value>
    </option>
    <option id="0" type="radio">
      <value>0</value>
    </option>
  </options>
</request>
```

--------------------------------

### Clone Product Description Response

Source: https://my.digiseller.com/inside/api/_catgoods

Example response formats for the product cloning API call, shown in both XML and JSON. The response indicates the success or failure of the operation and provides details about any errors encountered. Upon success, it returns an array of newly created product IDs.

```JSON
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": {
    "products": [
      23387571,
      23387572,
      23387573
    ]
  }
}
```

--------------------------------

### Retrieve Latest Sales (GET Request)

Source: https://my.digiseller.com/inside/api/_statistics

This snippet demonstrates how to make a GET request to the Digiseller API to fetch the latest sales. It requires an access token and seller ID. The response is returned in XML or JSON format, detailing each sale.

```HTTP
GET https://api.digiseller.com/api/seller-last-sales
Accept: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

---

GET https://api.digiseller.com/api/seller-last-sales
Accept: application/xml
Authorization: Bearer YOUR_ACCESS_TOKEN
```

--------------------------------

### Product Preview Videos API

Source: https://my.digiseller.com/inside/api/_catgoods

Retrieves information about preview videos for a product, including video type, ID, and preview image URL.

```APIDOC
## GET /websites/my_digiseller_inside_api/product/preview_videos

### Description
Retrieves parameters for preview videos associated with a product. Allows specifying the number of videos.

### Method
GET

### Endpoint
/websites/my_digiseller_inside_api/product/preview_videos

### Parameters
#### Query Parameters
- **cnt** (integer) - Optional - The number of preview videos to retrieve.

### Response
#### Success Response (200)
- **preview_videos** (array) - A list of preview video objects.
  - **video_type** (string) - The type of the video (e.g., 'youtube', 'vimeo').
  - **video_id** (string) - The ID of the video.
  - **video_preview** (string) - The URL of the video preview image.

#### Response Example
```json
{
  "preview_videos": [
    {
      "video_type": "youtube",
      "video_id": "dQw4w9WgXcQ",
      "video_preview": "https://example.com/path/to/preview.jpg"
    }
  ]
}
```
```

--------------------------------

### Create/Update Form Content - XML Request Example

Source: https://my.digiseller.com/inside/api/_content

An example of an XML request body to create or update product content of type 'form' via the Digiseller API. It mirrors the JSON structure with elements for product_id, address, method, encoding, and optional purchase-related settings.

```xml
<root>
  <product_id>1</product_id>
  <address>sample@email.ru</address>
  <method>Email</method>
  <encoding>UTF8</encoding>
  <options>true</options>
  <answer>true</answer>
  <allow_purchase_multiple_items>true</allow_purchase_multiple_items>
  <url_for_quantity>https://url-for-sending-a-request-with-the-quantity-specified-by-the-buyer.com/</url_for_quantity>
</root>
```

--------------------------------

### Edit Software Product - XML Request Example

Source: https://my.digiseller.com/inside/api/_goods

This XML snippet illustrates the structure for editing a software product. It mirrors the JSON structure, providing product details, pricing, category information, and other configurable options. Use this format when the `Content-Type` header is set to `text/xml`.

```xml
<request>
  <enabled>true</enabled>
  <name>
    <item>
      <locale>ru-RU</locale>
      <value>Тестовый продукт №1</value>
    </item>
    <item>
      <locale>en-US</locale>
      <value>Test product №1</value>
    </item>
  </name>
  <price>
    <price>725</price>
    <currency>RUB</currency>
  </price>
  <comission_partner>15</comission_partner>
  <categories>
    <item>
      <owner>0</owner>
      <category_id>7074</category_id>
    </item>
    <item>
      <owner>1</owner>
      <category_id>18162</category_id>
    </item>
  </categories>
  <bonus>
    <enabled>false</enabled>
    <percent>5</percent>
  </bonus>
  <guarantee>
    <enabled>true</enabled>
    <value>5</value>
  </guarantee>
  <description>
    <item>
      <locale>ru-RU</locale>
      <value>Тестовое описание</value>
    </item>
    <item>
      <locale>en-US</locale>
      <value>Test description</value>
    </item>
  </description>
  <add_info>
    <item>
      <locale>ru-RU</locale>
      <value>Тестовая дополнительная информация</value>
    </item>
    <item>
      <locale>en-US</locale>
      <value>Test additional information</value>
    </item>
  </add_info>
  <address_required>false</address_required>
  <trial_url>http://localhost</trial_url>
  <instruction>
    <type>text</type>
    <locales>
      <item>
        <locale>ru-RU</locale>
        <value>Русская инструкция</value>
      </item>
      <item>
        <locale>en-US</locale>
        <value>English instruction</value>
      </item>
    </locales>
  </instruction>
  <present_product_id>123321</present_product_id>
  <online_checkout_name>Тестовый продукт №1</online_checkout_name>
  <online_checkout_category>Goods</online_checkout_category>
  <online_checkout_tax>no_vat</online_checkout_tax>
</request>
```

--------------------------------

### Example JSON Response for Adding Files from ZIP

Source: https://my.digiseller.com/inside/api/_content

Example JSON response after successfully adding multiple files from a ZIP archive. It returns a success code, an empty description, null errors, and a content array listing each added file with its content ID and filename.

```JSON
{
  "retval": 0,
  "retdesc": "",
  "errors": null,
  "content": [
    {
      "content_id": 6403229,
      "filename": "New Text Document.txt"
    },
    {
      "content_id": 6403230,
      "filename": "New Text Document 2.txt"
    }
  ]
}
```

--------------------------------

### Get Generated Code Count (GET)

Source: https://my.digiseller.com/inside/api/_content

This method retrieves the number of codes generated for a specific product and variant. It supports both XML and JSON response formats. The `product_id` and `variant_id` parameters are used to filter the count. An access token with 'Content: View' permission is required.

```json
{ "retval": 0, "retdesc": "", "errors": null, "content": { "count": 0 } }
```

```xml
0 0
```

--------------------------------

### Edit Software Product - JSON Request Example

Source: https://my.digiseller.com/inside/api/_goods

This JSON snippet demonstrates how to format a request to edit a software product. It includes essential fields like product name, price, currency, categories, commission, bonus, guarantee, description, and online checkout details. Ensure all fields are correctly populated according to the API specifications.

```json
{
  "enabled": true,
  "name": [
    {
      "locale": "ru-RU",
      "value": "Тестовый продукт №1"
    },
    {
      "locale": "en-US",
      "value": "Test product №1"
    }
  ],
  "price": {
    "price": 725,
    "currency": "RUB"
  },
  "comission_partner": 15,
  "categories": [
    {
      "owner": 0,
      "category_id": 7074
    },
    {
      "owner": 1,
      "category_id": 18162
    }
  ],
  "bonus": {
    "enabled": false,
    "percent": 5
  },
  "guarantee": {
    "enabled": true,
    "value": 5
  },
  "description": [
    {
      "locale": "ru-RU",
      "value": "Тестовое описание"
    },
    {
      "locale": "en-US",
      "value": "Test description"
    }
  ],
  "add_info": [
    {
      "locale": "ru-RU",
      "value": "Тестовая дополнительная информация"
    },
    {
      "locale": "en-US",
      "value": "Test additional information"
    }
  ],
  "address_required": false,
  "trial_url": "http://localhost",
  "instruction": {
    "type": "text",
    "locales": [
      {
        "locale": "ru-RU",
        "value": "Русская инструкция"
      },
      {
        "locale": "en-US",
        "value": "English instruction"
      }
    ]
  },
  "present_product_id": 123321,
  "online_checkout_name": "Тестовый продукт №1",
  "online_checkout_category": "Goods",
  "online_checkout_tax": "no_vat"
}
```

--------------------------------

### Create/Update Form Content - JSON Request Example

Source: https://my.digiseller.com/inside/api/_content

An example of a JSON request body to create or update product content of type 'form' via the Digiseller API. It includes essential fields like product_id, address, method, encoding, and optional fields for purchase settings and URLs.

```json
{
  "product_id": 1,
  "address": "sample@email.ru",
  "method": "Email",
  "encoding": "UTF8",
  "options": true,
  "answer": true,
  "allow_purchase_multiple_items": "true",
  "url_for_quantity": "https://url-for-sending-a-request-with-the-quantity-specified-by-the-buyer.com/"
}
```
Tokens:
Raw