Что такое API ?

API (веб-сервис) - способ предоставления доступа для работы с сайтом JP auto.

Классический способ ознакомления с нашими предложениями - ввести вручную в поисковую строку каталожный номер интересующего товара.
API- предоставляет Вам возможность автоматизировать поиск с Вашего сайта на сайте JP auto.
Таким образом:
• На Вашем сайте, клиенты будут видеть наши предложения с Вашей наценкой.
• Для Вас отпадает необходимость регулярного обновления прайс-листом и их загрузки так как информацию Вы получаете в реальном времени.

Нужно ли мне API и для чего ?

Вам необходимо транслировать в поиске на сайте клиентам наши предложения с Вашей наценкой, значит Вам нужно API.

1. Свяжитесь с нами в разделе Личного кабинета > 'Вопрос-Ответ'.

2. Коротко и оперативно согласуем с Вами необходимые индивидуальные настройки под лично Ваши нужды и задачи.

3. Активируем доступ в течении 5 минут.

4. Доступ активирован, Вы можете пользоваться API доступом, используя для авторизации Ваш индивидуальный Ключ доступа = API ключ.
Ключ доступа = API ключ после активации отображен в разделе Личного кабинета > 'Профиль'.

Метод JSON SearchParts

Описание

Метод поиска детали. (проценка)
Метод возвращает коммерческое предложение (цены) для искомого товара и кроссам (аналогам).
Метод возвращает ответ идентичный по структуре и содержанию результату, который Вы видите на сайте при классическом, ручном поиске.

Тип запроса: GET

Тип авторизация: Bearer Token
Bearer Token = API ключ доступный в разделе Личного кабинета > 'Профиль' после активации доступа .

Этот метод работает в два шага.

ШАГ 1 - по интересующему номеру уточняется список брендов (производителей).
Ссылка: https://api.jpauto.com.ua/searchparts?n=4881533080
Где b - каталожный номер искомого товара.

ШАГ 2 - по интересующему номером и выбранному на первом шаге бренду осуществляем поиск деталей (проценку).
Ссылка: https://api.jpauto.com.ua/searchparts?n=4881533080&b=Toyota
Где n и b - каталожный номер искомого товара и название бренда (производителя), соответственно.

ВАЖНО! При острой необходимости, в случае твёрдой уверенности в целесообразности, можно пропускать ШАГ 1 и сразу обращаться к ШАГ 2 передавая название бренда (производителя) так как оно записано в Вашей БД и быть уверенными в том, что всю логику сопоставлению требуемого бренда с предложениями товаров выполнит наш гибкий, умный алгоритм.

Протестировать работоспособность, убедиться в том, что API для Вас активирован и API ключ верный, можно
ПО ССЫЛКЕ: https://reqbin.com/
см. примеры тестов на изображении ниже
ШАГ 1

ШАГ 2

JSON - Ответ в этом формате мы рекомендуем как формат по умолчанию. С ним легко работать, а ответы имеют меньший размер.
на пример: предложения по одному и тому же товару имеет размер в JSON = 2,4 mb, а в XML = 3.7 mb.

Пример ответа ШАГ 1

{
    "Brands": [{
        "Name": "Toyota"
    }]
}

Пример ответа ШАГ 2

{
    "Products":{
        "Search":[
            {
                "Number" : "04152YZZA1",
                "Brand" : "Toyota",
                "Qty" : "12",
                "QtyType" : "Equal",
                "Price" : "0.87",
                "Currency" : "USD",
                "Supplier" : "ABCD",
                "Delivery" : "truck",
                "DeliveryPrice" : "free" ,
                "Term" : "10",
                "Chance" : "4.5",
                "IsReturn" : "true",
                "Region": "Украина",
            },
            {...},
        ],
        "Cross":[
            {...},
            {...},
        ]
    }
}

XML - Ответ в этом формате мы не рекомендуем, но при острой необходимости можем включить XML индивидуально для клиента по его просьбе.
Мы рекомендуем ответ в формате JSON. Ответы JSON имеют меньший размер.
на пример: предложения по одному и тому же товару имеют размер в JSON = 2,4 mb, а в XML = 3.7 mb.

Пример ответа ШАГ 1

<Brands>
    <Brand>
        <Name>Toyota</Name>
    </Brand>
</Brands>

Пример ответа ШАГ 2

<Products>
    <Search>
        <Product>
            <Number>04152YZZA1</Number>
            <Brand>Toyota</Brand>
            <Qty>12</Qty>
            <QtyType>Equal</QtyType>
            <Price>0.87</Price>
            <Currency>USD</Currency>
            <Supplier>ABCD</Supplier>
            <Delivery>truck</Delivery>
            <DeliveryPrice>free</DeliveryPrice>
            <Term>10</Term>
            <Chance>4.5</Chance>
            <IsReturn>true</IsReturn>
            <Region>Украина</Region>
        </Product>
        <Product>
            ...
        </Product>
    </Search>
    <Cross>
        <Product>
            ...
        </Product>
        <Product>
            ...
        </Product>
    </Cross>
</Products>

Блок Search - предложения по искомому товару, запрашиваемой паре каталожный номер + наименование бренда.
Блок Cross - предложения по кроссам к искомому товару.

У каждого предложения обязательно присутствуют следующие поля:
• Number - Каталожный номер
• Brand - Бренд
• Qty - Количество
• QtyType связанно с Qty:
    Если QtyType = Exist, то Qty = 0 - товар в достатке в наличии, но точное количество не известно.
    Если QtyType = More, то в наличии больше чем Qty.
    Если QtyType = Equal, то Qty указан точно - товар в наличии именно в в количестве равном Qty.
• Price - Цена (стоимость за каталожный номер в количестве 1 шт)
• Currency - Валюта
• Supplier- Название поставщика, аббревиатура из 4 символов.
• DeliveryPrice связано с Price:
    Если DeliveryPrice = free, то Price указана с учётом доставки до нашего склада.
    Если DeliveryPrice = pay, то Price указана без учета доставки до нашего склада, доставка выставляется отдельно.
• Delivery связано с DeliveryPrice и Price:
    Если Delivery = home - Товар в наличии на нашем личном складе.
    Если Delivery = free, то Price указана с учётом доставки до нашего склада.
    Если Delivery = anchor, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = pay.
    Если Delivery = plane, то предложение подразумевает авиа доставку, при этом DeliveryPrice = pay.
    Если Delivery = incanchor, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = free, а Price указана с учётом доставки до нашего склада.
    Если Delivery = incplane, то предложение подразумевает контейнерную доставку морем, при этом DeliveryPrice = free, а Price указана с учётом доставки до нашего склада.
• Term - Срок поставки до нашего склада.
• Chance - Статистика, шанс успешной закупки.
• IsReturn- Возвратность поставщика.
• Region - Регион поставки.

<?php
$apiUrl = 'https://www.api.jpauto.com.ua/searchparts';
$bearerToken = 'YOUR API KEY';
$partNumber = '04152YZZA1';
$partBrand = 'toyota';

$ch= curl_init($apiUrl.'?n='.$partNumber.'&b='.$partBrand);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer '.$bearerToken]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);
var_dump($result);
?>

var apiUrl = "https://www.api.jpauto.com.ua/searchparts";
var bearerToken = "YOUR API KEY";
var partNumber = "04152YZZA1";
var partBrand = "toyota";

var httpRequest = (HttpWebRequest)WebRequest.Create($"{apiUrl}?n={partNumber}&b={partBrand}");
httpRequest.Headers["Authorization"] = $"Bearer {bearerToken}";

var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream())){
var result = streamReader.ReadToEnd();
}

Console.WriteLine(httpResponse.StatusCode);

let apiUrl = 'https://www.api.jpauto.com.ua/searchparts';
let bearerToken = 'YOUR API KEY';
let partNumber = '04152YZZA1';
let partBrand = 'toyota';

var xhr = new XMLHttpRequest();
xhr.open('GET', `${apiUrl}?n=${partNumber}&b=${partBrand}`);
xhr.setRequestHeader("Authorization", `Bearer ${bearerToken}`);

xhr.onreadystatechange = function () {
if (xhr.readyState === 4) {
console.log(xhr.status);
console.log(xhr.responseText);
}};

xhr.send();

DECLARE @authHeader VARCHAR (8000)
, @ret INT
, @token INT
, @url VARCHAR (8000)
, @RequestBody VARCHAR (8000)
-- Variable with Result
, @Result VARCHAR (MAX);

DECLARE @Results TABLE (Result VARCHAR (MAX) NULL);

-- Declaration customer variables (params)
DECLARE @APIkey VARCHAR (512)
, @n VARCHAR (50)
, @b VARCHAR (50);

-- Set variables (params)
SET @APIkey = 'YOUR API KEY';
SET @authHeader = 'Bearer ' + @APIkey;
SET @b = 'Toyota';
SET @n = '4881533100';
SET @url = 'https://www.api.jpauto.com.ua/searchparts?n='+@n+'&b='+@b;

SET @RequestBody = '{"key": "value"}';

EXEC @ret = sp_OACreate 'MSXML2.ServerXMLHTTP', @token OUT;
--- IF @ret <> 0 RAISERROR ( 'HTTP connection is not open.', 10, 1);
--- IF @ret = 0 RAISERROR ( 'HTTP connection is open.', 10, 1);

EXEC @ret = sp_OAMethod @token, 'Open', NULL, 'GET', @Url, false;
EXEC @ret = sp_OAMethod @token, 'setRequestHeader', NULL, 'Authorization', @authHeader;
EXEC @ret = sp_OAMethod @token, 'send', NULL, @RequestBody;
INSERT INTO @Results (Result)
EXEC sp_OAMethod @token, 'responseText';
SET @Result = (SELECT TOP (1) Result FROM @Results);
-- Select Result
SELECT @Result;

import requests
from requests.structures import CaseInsensitiveDict

url = "https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso"

headers = CaseInsensitiveDict()
headers["Authorization"] = "Bearer YOUR API KEY"


resp = requests.get(url, headers=headers)

print(resp.status_code)

URL url = new URL("https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso");
HttpURLConnection http = (HttpURLConnection)url.openConnection();
http.setRequestProperty("Authorization", "Bearer YOUR API KEY");

System.out.println(http.getResponseCode() + " " + http.getResponseMessage());
http.disconnect();

#!/bin/bash

curl -X GET https://www.api.jpauto.com.ua/searchparts?n=IK20TT&b=Denso -H "Authorization: Bearer YOUR API KEY"

Условия возврата:

1. Срок возврата со дня отгрузки / выдачи / готовности товара к отгрузке:
• Товар из наличия нашего склада - 14 дней
• Товар с партнерского склада - 12 дней

2. Должна быть сохранена изначальная※¹ комплектация товара.

3. Должна быть сохранена товарный вид※².

4. Должна быть сохранена упаковка в изначальном※¹ виде.

5. На товаре / упаковке должны сохраниться в целости все стикера, наклейки, этикетки, бирки.

6. На товаре не должно быть следов эксплуатации, установки.

7. На товаре / упаковке не должно быть клиентских стикеров, наклеек, этикеток, бирок.

8. Товар не должен быть привезённым из-за границы индивидуально для клиента※³.

9. Товар не должен относиться к / включать в себя / в комплект что то относящееся к следующим товарным группам:
• Электрика
• Электроника
• Топливная аппаратура
• Химия.

10. Товар должен был заказан со склада в предложении которого была иконка возвратности※⁴


※¹ Изначальная комплектация - комплектация в которой товар был отгружен / выдан с нашего склада.
※¹ Изначальный вид упаковки - внешний вид, состояние упаковки в котором она была отгружена / выдана с нашего склада.
※² Товарный вид - внешний вид, состояние товара, упаковки в котором он был отгружен / выдан с нашего склада.
※³ Индивидуально для клиента - Товар заказанный клиентом из-за границы, выкупленный и доставленный в Украину по индивидуальному заказу клиента. Не принимается на возврат ввиду невозможности возврата поставщику и невостребованности такого товара в наличии на нашем складе.
※⁴ Иконка возвратности - стрелочка зеленого или красного цвета (,) указывающая на возможность / не возможность возврата поставщику / на склад в рамках определённого предложения / заказа на общих условиях возврата.
например: Заказывая товар со склада с возможностью возврата, возврат всё равно будет не возможен в случае если товар относится к одной из товарных групп по которой не принимаются возвраты в соответствии с условиями возврата.

Как сделать возврат:

Мы принимаем исключительно согласованные возвраты.
ОБРАТИТЕ ВНИМАНИЕ! Не согласованные возвраты мы НЕ сопровождаем, НЕ обрабатываем, НЕ несём за них ответственность.
Высылая товар на возврат без согласования, Вы совершаете лишь одному себе понятное действие о котором известно так же только Вам.

Как согласовать возврат:

Для согласования возврата воспользуйтесь предусмотренной, соответствующей функцией сайта:
1. В разделе Личного кабинета > 'Позиции заказа' нажмите кнопку 'Запрос возврата' расположенную справа в строке заказа по которому Вы желаете согласовать возврат.

2. Ответ о возможности возврата, весь необходимый в дальнейшем функционал и вся необходимая дополнительная информация, будет предоставлена автоматически и / или доступна в разделе Личного кабинета > 'Возвраты'.

1. Die Gewahrleistungsfrist beginnt mit dem Verkaufsdatum. Nach Datum Als Verkaufsdatum gilt das Ausstellungsdatum der Waren- und Transportrechnung und/oder das Datum der Spesenrechnung und/oder das Datum des Ausfullens der Garantie Coupon
2. Aus dieser Lieferantengarantie ergibt sich ein Anspruch des Kaufers fur die kostenlose Reparatur des Produkts bei Feststellung von Material- und Montagefehlern nach Angaben des Herstellers.
3. Gewahrleistung sowie Nicht-Gewahrleistung und Nachgarantie Reparaturen werden von Service-Center-Spezialisten durchgefuhrt.
4. Gerate im Rahmen der Garantie werden zur Reparatur angenommen obligatorisches Vorhandensein korrekt ausgefuhrter Dokumente: eine Firmengarantiekarte mit Angabe Fabriknummer (falls vorhanden), Verkaufsdatum, Handelsstempel Organisation und die Unterschrift des Kaufers sowie bei Vorhandensein von Dokumenten, die den Kauf bescheinigen (Bargeld oder Wareneingang, Rechnung etc.).
5. Die Garantie gilt nicht fur:
- austauschbares Zubehor (Zubehor) und Ausrustung fur Ausrustung, zum Beispiel: Bohrer, Sageblatter, Messer und deren Befestigungselemente, Dorne, Kartuschen aller Art (Bohren, Drehen usw.), Nocken, Spannzangen usw. (siehe Liste der austauschbaren Zubehorteile/Zubehorteile);
- Vorrichtungen zum mechanischen Schutz der Maschine (Sicherheitskupplungen, Fangvorrichtungen und Sicherheitsnadeln), Vorrichtungen zum Schutz von Stromkreisen;
- schnell verschlei?ende Teile mit begrenzter Ressource, zum Beispiel: Kohlebursten, Antriebsriemen, Graphitpads, Schutzgehause, Fuhrungs- und Vorschubwalzen aller Art, Vorschubbander, Lager aller Art, Belage an Riemenscheiben Federn, Gummidichtungen, Oldichtungen. Sie ersetzen ist ein kostenpflichtiger Dienst;
- Netzkabel. Bei Schaden an der Isolierung ist ein Austausch des Netzkabels zwingend erforderlich.
6. Garantiereparaturen werden in den folgenden Fallen nicht durchgefuhrt Falle:
- die Garantiekarte entspricht nicht diesem Gerat;
- Ablauf der Garantiezeit; - Versuch der selbststandigen Zerlegung oder Reparatur von Geraten durch Unbefugte (Schaden). Schlitze der Schrauben, an den Verbindungsstellen des Gehauses mit anderen Ausrustungsteile, Einbau von nicht originalen Teilen Details usw.)**;
- die Luftungskanale des Gerates mit Staub bedeckt sind, Spane usw.
- dadurch naturlicher Verschlei? von Anlagenteilen langfristige Nutzung;
- das Vorhandensein von Rost und starker Verschmutzung an der Au?enseite und im Gerat**;
- unsachgema?er Betrieb (nicht bestimmungsgema?e Verwendung des Gerats, nicht bestimmungsgema?e Installation am Gerat). (vom Herstellerwerk vorgesehene Dusen, Zusatzgerate usw.)**; - bei au?erer mechanischer Beschadigung des Gerates; - bei Mangeln, die auf die Nichtbeachtung von Lager- und Transportvorschriften oder Umstanden zuruckzufuhren sind hohere Gewalt sowie widrige atmospharische oder sonstige au?ere Einflusse auf das Gerat, wie Regen, Schnee, hohe Luftfeuchtigkeit, Hitze, aggressive Umgebungen usw.;
- bei Schaden aufgrund von Nichtbeachtung Betriebsbedingungen gema? der Anleitung*** oder bauliche Veranderungen vornehmen (siehe Abschnitt „Technik“) Sicherheit"***);
- durch Uberlastung oder Blockierung (gleichzeitiger Ausfall von Rotor und Stator, beide Wicklungen). Stator oder andere Komponenten und Teile);**
- bei Mangeln aufgrund von Spannungsspitzen oder falschem Anschluss Ausrustung fur das Stromnetz;
- wenn Fremdkorper in das Gerat gelangen, zum Beispiel Sand, Steine, Insekten, Materialien oder Stoffe, die nicht abfallbegleitend sind Verwendungszweck; - bei daraus resultierenden Mangeln und Ausfallen Versaumnis, die geplante technische und vorbeugende Wartung, Reinigung und Schmierung der Ausrustung durchzufuhren, durch die Anleitung vorgesehen*** fur den Betrieb, selbstandiges Einleiten baulicher Veranderungen.
7. Eine Garantiereparatur von teilweise oder vollstandig zerlegten Geraten ist ausgeschlossen.
8. Die Pflicht, den technischen Zustand zu uberwachen, Einstellungen, Anpassungen, Fehlerbehebungen und Planungen vorzunehmen Die Wartung liegt in der Verantwortung des Benutzers Ausrustung.
9. Einrichtung, Anpassung, Fehlerbehebung, technische und vorbeugende Wartung von Geraten (z. B. Reinigen, Waschen, Schmieren, Austausch technischer Flussigkeiten) ist keine Garantieleistung.
10. Nach Ablauf der Dienstzeit wird eine Bewerbung empfohlen zur vorbeugenden Inspektion der Gerate an das Servicecenter.
11. Im Falle eines Versto?es wird das Gerat von der Garantie ausgeschlossen Betriebsregeln

* Die oben genannten Verpflichtungen sind allgemeiner Natur und gelten fur das gesamte Geratesortiment. Detaillierte Gewahrleistungspflichten fur jeden Geratemodelle unter Berucksichtigung ihrer Merkmale sind in der jeweiligen Betriebsanleitung wiedergegeben.
**Ermittelt durch Diagnose eines Service-Center-Spezialisten
*** Wenn im Lieferumfang keine Anleitung und „Sicherheitsausrustung“ enthalten ist, beachten Sie die standardma?igen, amtlich zugelassenen Informationen zu diesem Thema! Bedingungen fur Gerate (Maschinen)