Api docs

Вы можете использовать наш API для импорта\обновления\удаления офферов

Для этого нужно отправить HTTP POST запрос в формате json на url https://diasp.pro/api/?v=1.0.0

Заголовок запроса должен содержать ваш api key для авторизации на сервере, тип авторизации - Bearer Token, посмотреть api key можно в личном кабинете здесь

Тело запроса должно содержать объект с 2 ключами:

• action(type - string) - действие, которое будет совершаться, допустимые параметры
  (insert, update, delete)


• offers(type - array)
  - массив объектов с офферами

Каждый объект должен содержать:

• offer_uid(type - int\string) - ваш уникальный id оффера


• offer_title(type - string) - название оффера


• offer_payment(type - string) - вознаграждение


• offer_payment_currency(type - string\array) - валюта вознаграждения, в формате ISO 4217:2015 (RUB, USD, EUR)
  подробнее о формате https://ru.wikipedia.org/wiki/


• offer_payment_type(type - string\array) - выплата,
  допустимые параметры (cpa, cpl, doi, revenue-share, soi, deposit, confirmed-order, percent)


• offer_geo(type - string\array) - гео оффера, в формате ISO 3166-1 Alpha-2 (RU, US, GB)
  подробнее о формате https://ru.wikipedia.org/wiki/


• offer_category(type - string\array) - вертикаль,
  допустимые параметры (adult, betting, cripto, dating, e-commerce, education, finance, gambling, hr, igaming, nutra )



• offer_link(type - string) - ссылка на оффер\партнерку

Пример объекта, который можно отправить

                        {
                        "action":"insert",
                        "offers":[
                                {
                                "offer_uid": "1234567890",
                                "offer_title":"Demo offer name 1",
                                "offer_payment":"0,13 - 42,65",
                                "offer_payment_currency":"USD",
                                "offer_geo":["GB","US"],
                                "offer_category":"dating",
                                "offer_payment_type":"revenue-share",
                                "offer_link":"https:\/\/some.site\/sl\/637vYg"
                                },
                                {
                                "offer_uid": "abcdefghij",
                                "offer_title":"Demo offer name 2",
                                "offer_payment":"1250",
                                "offer_payment_currency":"RUB",
                                "offer_geo":"RU",
                                "offer_category":"nutra",
                                "offer_payment_type":["cpa","confirmed-order"],
                                "offer_link":"https:\/\/demo.com\/sl\/637vYg"
                                },
                                {
                                "offer_uid": "1a2b3c4d5e",
                                "offer_title":"Demo offer name 3",
                                "offer_payment":"15",
                                "offer_payment_currency":["USD","EUR"],
                                "offer_geo":["ru","ua"],
                                "offer_category":"dating",
                                "offer_payment_type":"deposit",
                                "offer_link":"https:\/\/mysite.global\/sl\/637vYg"
                                }
                            ]
                        }

Пример реализация отправки запроса на PHP с использованием Curl

                        $url = 'https://diasp.pro/api/?v=1.0.0';
                        $token = 'YOUR API KEY';
                        $data = [
                                'action'=>'insert',
                                'offers'=>[
                                            [
                                                "offer_uid": "1234567890",
                                                "offer_title":"Demo offer name 1",
                                                "offer_payment":"0,13 - 42,65",
                                                "offer_payment_currency":"USD",
                                                "offer_geo":["GB","US"],
                                                "offer_category":"dating",
                                                "offer_payment_type":"revenue-share",
                                                'offer_link' => 'https://mylead.global/sl/637vYg',
                                            ],
                                            [
                                                "offer_uid": "abcdefghij",
                                                "offer_title":"Demo offer name 2",
                                                "offer_payment":"1250",
                                                "offer_payment_currency":"RUB",
                                                "offer_geo":"RU",
                                                "offer_category":["betting","gambling"],
                                                "offer_payment_type":["cpa","confirmed-order"],
                                                'offer_link' => 'https://mylead.global/sl/637vYg',
                                            ],
                                            [
                                                "offer_uid": "1a2b3c4d5e",
                                                "offer_title":"Demo offer name 3",
                                                "offer_payment":"15",
                                                "offer_payment_currency":["USD","EUR"],
                                                "offer_geo":["ru","ua"],
                                                "offer_category":"dating",
                                                "offer_payment_type":"deposit",
                                                'offer_link' => 'https://mylead.global/sl/637vYg',
                                            ]
                                        ]
	                            ];

		$headers = [ 'accept: application/json', 'Authorization: Bearer ' . $token, 'Content-Type: application/json' ];

		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
		curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);

		$response = curl_exec($ch);
		$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

		curl_close($ch);

		if ($httpcode >= 200 && $httpcode < 300) {
			return $response;
		} else {
			return "Error: " . $response;
		}

                    

Коды ответов сервера

200 Success - успешный запрос, пример ответа

Тело ответа содержит массив объектов оферов с дополнительной информацией по каждому

ключ объекта - offer_uid ваш уникальный id оффера

                        {
                            "action": "insert",
                            "offers": [
                                {
                                    "1a2b3c4d5e1": {
                                        "status": "success"
                                    }
                                },
                                {
                                    "abcdefghij": {
                                        "status": "error",
                                        "msg": "Offer already exists"
                                    }
                                },
                                {
                                    "1a2b3c4d5e": {
                                        "status": "error",
                                        "msg": "Offer already exists"
                                    }
                                }
                            ]
                        }
                    

400 Bad Request - Ошибка в формате данных
401 Unauthorized - Неверный api key авторизации запроса
403 Forbidden - Отсутствует api key в авторизации запроса
405 Method Not Allowed - Неверный метод\url запроса