Документація по API

POST order

URL

http://api.brain.com.ua/order/SID

HTTP Метод

POST

Опис

Метод додавання товарів у кошик. Якщо товар вже присутній у кошику, він оновлюється відповідно до зазначених даних.
Для додавання товарів потрібно відправити POST запит зі змінною "data", в якій міститься валідний JSON рядок (див. специфікацію JSON) - список товарів у наведеному нижче форматі.

Параметри URL

Назва параметра	Обов'язковий параметр	Опис
SID	так	ідентифікатор сесії

Параметри POST запиту

Назва параметра	Обов'язковий параметр	Опис
data	так	змінна, яка містить рядок JSON зі списком замовлень
recipient_type	ні (так - для комісійного продажу)	тип кінцевого клієнта (0 - фіз.особа, 1 - юр.особа; за замовчуванням 0)

Параметри списку товарів у JSON

Назва параметра	Обов'язковий параметр	Опис
productID	ні (якщо вказано product_code або articul)	ID товару, який потрібно додати до замовлення
product_code	ні (якщо вказано productID або articul)	код товару, який потрібно додати до замовлення
articul	ні (якщо вказано productID або product_code)	артикул товару, який потрібно додати до замовлення
quantity	так	кількість одиниць товару
recipient_price	ні (так - для комісійного продажу)	ціна товару для рахунку
comment	ні	коментар до товару

Товар може бути ідентифікований за productID, product_code, articul або будь-якому їх поєднанню.Тобто, обов'язково має бути зазначений хоча б один із цих параметрів.

Результат

Повертає JSON об'єкт із статусом виконання операції (1 якщо успішно)

Приклад даних, що надсилаються

    data=[
        {"productID":"15949","quantity":"12","recipient_price":"1299.00","comment":"thank for service"},
        {"product_code":"B0015377","quantity":"1","recipient_price":"513.00"}
    ]

Формат даних у JSON для надсилання

    [{
        "productID":"15949",
        "quantity":"12",
        "recipient_price":"1299.00",
        "comment":"thank for service"
    }, {
        "product_code":"B0015377",
        "quantity":"1",
        "recipient_price":"513.00"
    }]

Приклад PHP коду для надсилання з використанням CURL


    $url; // URL адреса API с SID
    $data = json_encode( array(
        array(
            'productID'       => '15949',
            'quantity'        => '12',
            'recipient_price' => '1299.00',
            'comment'         => 'thank for service'
        ),
        array(
            'product_code'    => 'B0015377',
            'quantity'        => '1',
            'recipient_price' => '513.00'
        )
    ) );

    $ch = curl_init();

    curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

    curl_setopt( $ch, CURLOPT_POST, 1 );

    curl_setopt( $ch, CURLOPT_POSTFIELDS, array(
        'data' => $data
    ));

    curl_setopt( $ch, CURLOPT_URL, $url );

    $result = curl_exec($ch); // JSON зі статусом

Приклад відповіді

    {"status":"1","result":"1"}