Sima-land API v3

https://www.sima-land.ru/api/v3/help
Admin
The Sima-land.ru API v3 provides RESTful access to information about goods, orders, their status,...
Tokens:195,729
Snippets:654
Trust Score:9.9
Update:11 months ago
Show doc for...
Tokens:
Raw
### Get Sima-land Price List Request List via API v3

Source: https://www.sima-land.ru/api/v3/help/index

Shows how to retrieve a list of price list requests using the Sima-land API v3. Examples are provided in cURL and PHP for making the GET request.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/price-list-request/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/price-list-request/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get List of Trademarks using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet provides code examples in cURL and PHP to fetch a list of all available trademarks. It requires setting the 'Accept' header to 'application/json' for a JSON response.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/trademark/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/trademark/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Expand API Fields Example (GET Request)

Source: https://www.sima-land.ru/api/v3/help/index

Demonstrates how to use the `expand` GET parameter to retrieve specific additional fields when fetching order details from the Sima-land API v3. This allows for customization of the returned data.

```http
GET https://www.sima-land.ru/api/v3/order/<ID>/?expand=foo,bar
```

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

### Get List of 'Most Liked' Items using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This section provides code examples in cURL and PHP to retrieve a list of products that are 'most liked'. It includes an example of how to use the 'expand' GET parameter to fetch additional fields for each item, such as materials, authors, and categories.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/item-most-liked/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-most-liked/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get List: Messages (cURL, PHP)

Source: https://www.sima-land.ru/api/v3/help/index

This section provides code examples in cURL and PHP for retrieving a list of messages using the Sima-land API v3. It includes details on basic authentication and specifying the JSON accept header. Information on query parameters for filtering and sorting is also mentioned.

```curl
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/message/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/message/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get List of Claim Items using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This demonstrates how to retrieve a list of claim items via the Sima-land API v3. Examples using cURL and PHP are given, including the necessity of basic authentication. The API allows filtering by `claim_id` and expanding fields using the `expand` parameter.

```shell
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/claim-item/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/claim-item/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Sima-land API v3: Get Product Categories

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of all available product categories. This is a simple GET request and does not require authentication or a request body. Returns JSON data.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/category/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/category/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Sima-land Price List Request via API v3

Source: https://www.sima-land.ru/api/v3/help/index

Illustrates the process of creating a price list request via the Sima-land API v3. Includes cURL and PHP examples, specifying parameters like URL and category ID.

```shell
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://www.sima-land.ru/api/v3/price-list-request/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/price-list-request/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'url' => '<URL>',
    'category_id' => '<CATEGORY_ID>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### GET /api/v3/option/

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of all available product options. Supports JSON content type.

```APIDOC
## GET /api/v3/option/

### Description
Retrieves a list of all available product options.

### Method
GET

### Endpoint
/api/v3/option/

### Parameters
None

### Request Example
```bash
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/option/"
```

### Response
#### Success Response (200)
- The response attributes are similar to retrieving a single record.

#### Response Example
```json
[
  {
    "id": 1,
    "name": "Color",
    "attr_id": 10,
    "icon": "color_icon.png",
    "color": "#FF0000",
    "parent_option_id": null,
    "priority": 1,
    "filter_page_id": 5
  }
]
```
```

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

### Get Item Comments List using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Provides methods to retrieve a list of item comments from the Sima-land API v3. Supports filtering and sorting through GET parameters. Both cURL and PHP examples show how to make a GET request to the endpoint.

```bash
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/item-comment/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-comment/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Organizer Prepayment Terms

Source: https://www.sima-land.ru/api/v3/help/index

Creates new prepayment terms for a group purchase organizer. Requires 'Content-Type: application/json' and basic authentication with login and password. The request body should include user ID and an array of prepayment conditions.

```shell
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/jp-prepayments/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/jp-prepayments/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'user_id' => '<USER_ID>',
    'jp_prepayments' => '<JP_PREPAYMENTS>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Delivery Directions List - cURL

Source: https://www.sima-land.ru/api/v3/help/index

Fetches a list of delivery directions from the Sima-land API v3. Accepts JSON and can expand fields using the 'expand' GET parameter. No specific authentication is shown in this example.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/delivery-direction/"
```

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

### GET /api/v3/series/

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of all product series.

```APIDOC
## GET /api/v3/series/

### Description
Retrieves a list of all product series.

### Method
GET

### Endpoint
`https://www.sima-land.ru/api/v3/series/`

### Response
#### Success Response (200)
- **[Array of series objects]**
  - **id** (integer) - The unique identifier of the series.
  - **name** (string) - The name of the series.

#### Response Example
```json
[
  {
    "id": 101,
    "name": "Electronics"
  },
  {
    "id": 102,
    "name": "Home Goods"
  }
]
```
```

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

### Create Sima-land Order via API v3

Source: https://www.sima-land.ru/api/v3/help/index

Demonstrates how to create a new order using the Sima-land API v3. It includes examples using cURL and PHP, specifying necessary authentication and data fields like payment type and manager ID.

```shell
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/order/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/order/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'payment_type_id' => '<PAYMENT_TYPE_ID>',
    'manager_id' => '<MANAGER_ID>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Single Item Comment using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Illustrates how to fetch a single item comment by its ID using the Sima-land API v3. The examples in cURL and PHP demonstrate making a GET request to a specific comment's URL.

```bash
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/item-comment/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-comment/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### POST /api/v3/user-contact/

Source: https://www.sima-land.ru/api/v3/help/index

Creates a new user contact.

```APIDOC
## POST /api/v3/user-contact/

### Description
Creates a new user contact record. You need to provide the necessary fields in the request body.

### Method
POST

### Endpoint
`https://www.sima-land.ru/api/v3/user-contact/`

### Request Body
- **contact_type_id** (int) - Required - The ID of the contact type.
- **user_id** (int) - Required - The ID of the user to associate the contact with.
- **value** (string) - Required - The contact information (e.g., email address, phone number).
- **is_whatsapp** (bool) - Optional - Set to true if this contact is a WhatsApp number.
- **is_viber** (bool) - Optional - Set to true if this contact is a Viber number.
- **is_telegram** (bool) - Optional - Set to true if this contact is a Telegram contact.

### Request Example
```json
{
  "contact_type_id": 1,
  "user_id": 1,
  "value": "new.contact@example.com",
  "is_whatsapp": false
}
```

### Response
#### Success Response (201 Created)
- The response will typically contain the newly created user contact object, similar to the GET single record response.
```

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

### Get Delivery Time List using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of available delivery time slots from the Sima-Land API. Both cURL and PHP examples are provided for accessing the '/api/v3/delivery-time/' endpoint. The API supports an 'expand' GET parameter for additional fields.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/delivery-time/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/delivery-time/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get List of Check Items using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This section illustrates how to retrieve a list of check items from the Sima-land API v3. It includes examples using cURL and PHP, requiring basic authentication with login and password. The API supports an `expand` GET parameter for fetching additional fields.

```shell
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/check-item/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/check-item/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Cart Items List (cURL)

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of items currently in the user's shopping cart. This method uses a simple cURL command to make a GET request to the API endpoint. No specific input parameters are shown in this example, but the API supports various query parameters for filtering and expanding data.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/cart-item/"
```

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

### Get List of Orders via API

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of orders. Authentication with login and password is required, and the response is in JSON format.

```curl
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/order/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/order/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Item Question Reaction (API v3)

Source: https://www.sima-land.ru/api/v3/help/index

Creates a new item question reaction record via the Sima-land API v3. Requires authentication with login and password, and accepts JSON data for the reaction. Essential attributes include user_id, item_question_id, and is_like.

```bash
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/item-question-reaction/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-question-reaction/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'user_id' => '<USER_ID>',
    'item_question_id' => '<ITEM_QUESTION_ID>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get User Phone List API v3 (cURL & PHP)

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of user phone numbers, requiring authentication with login and password. Examples provided for cURL and PHP.

```curl
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/user-phone/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/user-phone/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### User Creation API

Source: https://www.sima-land.ru/api/v3/help/index

Allows for the creation of a new user record. Requires authentication and provides fields for user details.

```APIDOC
## POST /api/v3/user/

### Description
Creates a new user record.

### Method
POST

### Endpoint
https://www.sima-land.ru/api/v3/user/

### Parameters
#### Request Body
- **name** (string) - Required - Имя (Name)
- **email** (string) - Required - Электронная почта (Email)
- **phone** (string) - Optional - Телефон (Phone)
- **birth_date** (string) - Optional - Дата рождения (Birth Date)
- **district_id** (int) - Optional - Идентификатор района (District ID)
- **is_subscribed_for_newsletter** (int) - Optional - Подписан на новостную рассылку (Subscribed to Newsletter)
- **is_subscribed_for_delivery** (int) - Optional - Подписан на уведомления об отправлениях груза с заказами (Subscribed to Delivery Notifications)
- **settlement_id** (int) - Optional - Идентификатор поселения (Settlement ID)
- **token_push** (array) - Optional - Массив токенов для push уведомлений приложения (Array of push notification tokens)
- **is_subscribed_trigger** (int) - Optional - Подписан на триггерные письма (Subscribed to Trigger Emails)
- **selected_jp_organizer_id** (int) - Optional - Идентификатор выбранного организатора СП (Selected Joint Purchase Organizer ID)
- **is_push_preffered** (bool) - Optional - Присылать push уведомления вместо смс (Prefer Push Notifications over SMS)
- **is_subscribed_for_manager** (bool) - Optional - Подписан на сообщения от менеджера (Subscribed to Manager Messages)
- **is_subscribed_to_the_promotions_digest** (bool) - Optional - Подписан на акции и скидки (Subscribed to Promotions Digest)
- **is_subscribed_to_article** (bool) - Optional - Подписан на лучшие статьи сайта (Subscribed to Best Articles)
- **is_subscribed_for_waiting_list** (bool) - Optional - Подписан на лист ожидания (Subscribed to Waiting List)

### Request Example
```json
{
  "name": "<NAME>",
  "email": "<EMAIL>",
  "phone": "<PHONE>"
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message

#### Response Example
```json
{
  "message": "User created successfully"
}
```
```

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

### Get Single User Phone Record API v3 (cURL & PHP)

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a specific user phone number record by its ID, requiring authentication. Examples provided for cURL and PHP.

```curl
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/user-phone/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/user-phone/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Subscription API

Source: https://www.sima-land.ru/api/v3/help/index

Endpoint for creating new subscriptions.

```APIDOC
## POST /api/v3/lead/

### Description
Creates a new subscription.

### Method
POST

### Endpoint
https://www.sima-land.ru/api/v3/lead/

### Parameters
#### Request Body
- **lead_form_type_id** (int) - Required - The ID of the subscription form type.
- **email** (string) - Required - The email address for the subscription.
- **referrer** (string) - Optional - The page from which the subscription originated.
- **is_active** (bool) - Optional - Whether the subscription is active.
- **is_confirmed** (bool) - Optional - Whether the subscription is confirmed.
- **settlement_id** (int) - Optional - The user's settlement ID at the time of subscription.
- **created_at** (string) - Optional - The time of subscription creation.
- **updated_at** (string) - Optional - The time of subscription update.
- **user_id** (int) - Optional - The ID of the user.

### Request Example
```json
{
  "lead_form_type_id": "<LEAD_FORM_TYPE_ID>",
  "email": "<EMAIL>"
}
```

### Response
#### Success Response (200)
Details of the created subscription.

#### Response Example
```json
{
  "example": "response body"
}
```
```

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

### Get Single Page Record API v3 (cURL & PHP)

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a single record from the page endpoint using its ID. Supports JSON response. Examples provided for cURL and PHP.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/page/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/page/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Sima-land Catalog Request via API v3

Source: https://www.sima-land.ru/api/v3/help/index

Provides examples for creating a catalog request through the Sima-land API v3. This includes cURL and PHP snippets, detailing required parameters such as email and phone number.

```shell
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://www.sima-land.ru/api/v3/catalog-request/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/catalog-request/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'email' => '<EMAIL>',
    'phone' => '<PHONE>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Wish Collection List using Curl

Source: https://www.sima-land.ru/api/v3/help/index

This example uses cURL to retrieve a list of wish collections from the Sima-Land API v3. It includes the necessary 'Accept: application/json' header for JSON response.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/wish-collection/"
```

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

### Get List of Options

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of available options. Requires an 'Accept: application/json' header. The returned attributes are similar to those for retrieving a single news item.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/option/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/option/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### List Advertisers using PHP

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of advertisers using PHP's cURL functions. It includes basic authentication and sets the 'Accept: application/json' header.

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/advertiser/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Currency List using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of available currencies from the Sima-Land API. Examples are provided for both cURL and PHP, utilizing the '/api/v3/currency/' endpoint. The response is expected in JSON format.

```curl
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/currency/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/currency/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get News List - PHP

Source: https://www.sima-land.ru/api/v3/help/index

Fetches a list of news items using PHP's cURL library, setting the 'Accept' header to 'application/json'. This example shows basic news retrieval, and can be extended with query parameters.

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/news/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### POST /api/v3/jp-prepayments/

Source: https://www.sima-land.ru/api/v3/help/index

Creates a new prepayment condition for an organizer.

```APIDOC
## POST /api/v3/jp-prepayments/

### Description
Creates a new prepayment condition for an organizer. Each item in the `jp_prepayments` array defines conditions based on order sum and calculation method.

### Method
POST

### Endpoint
`https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/jp-prepayments/`

### Parameters
#### Request Body
- **user_id** (integer) - Required - The identifier of the user (organizer).
- **jp_prepayments** (array) - Required - An array of prepayment condition objects. Each object should contain:
    - **user_id** (integer) - The user ID.
    - **sum_from** (integer) - The minimum order sum for this condition.
    - **sum_to** (integer) - The maximum order sum for this condition.
    - **qty** (integer) - The value for the prepayment calculation.
    - **jp_payment_method_id** (integer) - The prepayment calculation method ID (1: % of order sum, 2: fixed amount).

### Request Example
```json
{
  "user_id": "<USER_ID>",
  "jp_prepayments": [
    {
      "user_id": "<USER_ID>",
      "sum_from": 0,
      "sum_to": 500,
      "qty": 5,
      "jp_payment_method_id": 1
    }
  ]
}
```

### Response
#### Success Response (200)
Returns the created prepayment condition object.

#### Response Example
```json
{
  "id": 1,
  "user_id": "<USER_ID>",
  "jp_prepayments": [
    {
      "id": 1,
      "user_id": "<USER_ID>",
      "sum_from": 0,
      "sum_to": 500,
      "qty": 5,
      "jp_payment_method_id": 1
    }
  ]
}
```
```

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

### Get List of Tire Widths using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet demonstrates how to retrieve a list of all tire widths using the SIMA-LAND API v3. It includes examples for both cURL and PHP, specifying the 'Accept' header for JSON responses.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/tire-width/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/tire-width/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Order using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Demonstrates how to create a new order via the API using both cURL and PHP. Requires authentication with login and password, and specifies order details like payment type and manager ID. The API endpoint for order validation is used for creation.

```curl
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/order-validate/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/order-validate/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'payment_type_id' => '<PAYMENT_TYPE_ID>',
    'manager_id' => '<MANAGER_ID>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get List of Legal Entities using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet demonstrates how to retrieve a list of legal entities from the SIMA-LAND API v3, including basic authentication. Examples are provided for cURL and PHP, with options for specifying login credentials.

```shell
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/legal-entity/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/legal-entity/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Specific Item Barcode by ID using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet shows how to fetch details for a specific item barcode by its ID from the SIMA-LAND API v3. Examples are provided in cURL and PHP, with the 'Accept' header set to 'application/json'.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/item-barcode/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-barcode/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Authentication

Source: https://www.sima-land.ru/api/v3/help/index

Obtain an API token by logging into the Sima-land website, navigating to the token page, creating a new key, and using it in the `x-api-key` header for API requests. Tokens are valid for one year.

```APIDOC
## Authentication

### Obtaining a Token

1. Log in to the Sima-land website.
2. Navigate to the token page: `https://www.sima-land.ru/cabinet/token/`
3. Create a new API key with a descriptive name.
4. Use the generated key in the `x-api-key` header for requests to `api/v3` (and `api/v5`).

Example header:
`x-api-key: <your_generated_token>`

Tokens are valid for one year from the date of creation.
```

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

### List Advertisers using cURL

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of advertisers using a cURL command. It requires basic authentication with login and password.

```shell
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/advertiser/"
```

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

### Get List of Item Barcodes using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet demonstrates retrieving a list of item barcodes from the SIMA-LAND API v3. It provides examples using both cURL and PHP, ensuring the 'Accept' header is configured for JSON output.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/item-barcode/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/item-barcode/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Entity Documentation

Source: https://www.sima-land.ru/api/v3/help/index

This section provides a comprehensive list of entities available through the API, covering various aspects of the Sima-land platform such as products, orders, users, organizational details, and more. Each entity can potentially be accessed via corresponding API endpoints.

```APIDOC
## Entities

This section lists all available entities in the Sima-land API. Each entity may have associated API endpoints for CRUD operations.

- Author
- Authorization via Oauth2
- Counterparty Delivery Address
- Organizer's Self-Pickup Address
- Delivery Addresses
- Organizer's Address Delivery
- Reconciliation Acts
- "Volume Discount" Action
- Contest Forms
- Product/Category Attribute
- Order Validation
- Currency
- Delivery Time
- Tire Sidewall Height Relative to Wheel Rim Center Plane
- Tire Profile Height
- Vote for Work in Drawing Contest
- Delivery Cities
- Contact Group
- Car Wheel Disk Diameter
- Diameter of the Circle on Which the Centers of the Fastening Holes of the Car Wheel Disk Are Located
- Car Wheel Disk Center Hole Diameter
- Tire Diameter
- File Manager
- Available Packaging Types
- Unit of Measurement
- Order in a Joint Purchase System
- Orders Attracted by an Advertising Contractor
- Orders
- Price List Request
- Drawing Contest Application
- User Call Request
- Favorites Summary
- Favorite Products
- Favorite Categories
- Tire Load Index
- Tire Speed Index
- Authorized User Informers
- Informers
- Sima-land Address Delivery Calculator
- Product Category
- Number of Fastening Points of a Car Wheel Disk
- News Comment
- Comment on an Answer to a Claim Item
- User Contacts
- Counterparty
- Shopping Cart
- Bulk Wholesale
- Product Waiting List
- Material
- Manager
- Car Model
- Car Modification
- Delivery Directions
- Our Legal Entities
- News
- Transportation Restrictions
- Product/Category Attribute Option
- Joint Purchase Organizer
- Claim Answer
- Claim Response
- Product Review
- Review Reaction
- Order Rating
- Manager Rating
- Moving Products Between Carts
- Gifts
- Collections
- Newsletter Subscriptions
- Sub-filter Page
- Search Suggestions
- JWT Receipt
- Users
- Settlement
- Claim
- Product Linking to Promotions
- Linking User Tokens
- Attachment to Comment
- Reason for Cancelling a Joint Purchase Application
- Claim Reason
- Pickup Points
- Photo Sizes
- Districts
- Delivery Schedule
- Sale
- Reaction to Response
- Linking Attribute to Product
- Linking Users and Push Notifications
- Linking Product in Favorites and Collections
- Tire Seasonality
- Product Series
- Joint Purchase
- Session Creator
- Message to Parts Manager
- Website Error Messages
- Messages
- Manager Specializations
- Rating Directory
- Delivery Cost
- Country
- Pages
- User Phones
- Tenders
- Promotion Type
- Product/Category Attribute Value Type
- User Contact Type
- Payment Type
- Claim Reason Type
- Pickup Type
- Product Certificate Type
- Packaging Type
- Product
- Product in Cart
- Invoice Product
- Product Item in Claim
- Products "Many Liked"
- Products Not Included in Order
- Trademarks
- Pickup Point
- Transport Company
- Deleting All Products from Both User Carts
- Delivery Conditions
- Joint Purchase Organizer Payment Conditions
- Joint Purchase Organizer prepayment Conditions
- Transportation Conditions
- Order Files
- Designer Contest Participant Files
- Requested Catalog Format
- Forms of Ownership
- Photo of a Product Item in a Claim
- Photo of Someone Else's Box in a Claim
- Car Wheel Disk Width
- Tire Width
- Product Barcodes
- Legal Entity
```

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

### Get Specific Tire Width by ID using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet shows how to fetch details for a specific tire width by its ID via the SIMA-LAND API v3. Examples in cURL and PHP are provided, with the 'Accept' header set to 'application/json'.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/tire-width/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/tire-width/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Create Organizer Payment Terms

Source: https://www.sima-land.ru/api/v3/help/index

Creates new payment terms for a group purchase organizer. Requires 'Content-Type: application/json' and basic authentication with login and password. The request body should contain user ID and an array of payment conditions.

```shell
curl -i -H "Content-Type: application/json" -d '<MODEL-JSON-DATA>' "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/jp-payments/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/jp-payments/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
$createFieldsData = array(
    'user_id' => '<USER_ID>',
    'jp_payments' => '<JP_PAYMENTS>',
    // значения всех атрибутов, необходимые для создания записи
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $createFieldsData);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Get Specific Wheel Width by ID using cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

This snippet illustrates how to fetch details for a specific wheel width by its ID from the SIMA-LAND API v3. Both cURL and PHP examples are provided, ensuring the 'Accept' header is set to 'application/json'.

```shell
curl -i -H "Accept:application/json" "https://www.sima-land.ru/api/v3/wheel-width/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/wheel-width/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$json = curl_exec($curl);
curl_close($curl);
?>
```

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

### Category API

Source: https://www.sima-land.ru/api/v3/help/index

Retrieves a list of product categories.

```APIDOC
## GET /api/v3/category/

### Description
Retrieves a list of product categories.

### Method
GET

### Endpoint
https://www.sima-land.ru/api/v3/category/

### Response
#### Success Response (200)
- **id** (integer) - The ID of the category.
- **name** (string) - The name of the category.

### Response Example
```json
[
  {
    "id": 1,
    "name": "Electronics"
  },
  {
    "id": 2,
    "name": "Clothing"
  }
]
```
```

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

### Get Single Claim Item - cURL and PHP

Source: https://www.sima-land.ru/api/v3/help/index

Retrieve a single claim item by its ID using the Sima-land API v3. This snippet includes examples for both cURL and PHP, demonstrating how to authenticate and specify the desired resource. The response is in JSON format.

```curl
curl -i -H "Accept:application/json" "https://<LOGIN>:<PASSWORD>@www.sima-land.ru/api/v3/claim-item/<ID>/"
```

```php
<?php
$curl = curl_init('https://www.sima-land.ru/api/v3/claim-item/<ID>/');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Accept: application/json'));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($curl, CURLOPT_USERPWD, '<LOGIN>:<PASSWORD>');
$json = curl_exec($curl);
curl_close($curl);
?>
```
Tokens:
Raw