API, интеграция
Ссылка на API
https://pixeloff.ru/api/v2.php?k=вашключ&u=ссылканаобъявление
При первом запросе API запускается обработка (status=searching) объявления, указанного
в параметре u. При последующих запросах к API с теми же параметрами обработка уже не инициируется,
а просто выводится результат действующей обработки.
Пока идёт обработка (очистка фото), будет возвращаться status=processed, когда обработка
завершится — status примет значение done и станут доступны ссылки на очищенные фото.
Параметры запроса
| Параметр | Описание |
|---|---|
k | Ключ доступа. Укажите ваш ключ доступа. Для работы API ключ должен иметь положительный баланс. |
u | URL объявления. Ссылка на объявление. Рекомендуется использовать urlencode. |
Данные ответа
| Поле | Тип | Описание |
|---|---|---|
status | string | Статус обработки: searching — поиск; processed XX% — обработка; done — завершено; error — ошибка. |
ID | integer | ID объявления в источнике. |
api_id | integer | ID объявления Pixeloff. |
title | string | Заголовок объявления. |
address | string | Адрес указанный в объявлении. |
parameters | array | Массив параметров объявления. |
description | string | Описание из объявления. |
price | integer | Стоимость указанная в объявлении. |
photos | array | Массив очищенных фотографий. |
balance | integer | Ваш баланс (остаток объявлений). |
Пример ответа (успех)
{
"status": "done",
"ID": "14442053**",
"api_id": "12345**",
"title": "Комната 20 м² в 1-к, 3/5 эт.",
"address": "Тюменская обл., Тюмень, мкр Войновка, Станционная ул., 36А",
"parameters": {
"Площадь комнаты": "20 м²",
"Комнат в квартире": "1",
"Этаж": "3 из 5",
"Тип дома": "Кирпичный"
},
"description": "Продам комнату в общежитии блочного типа...",
"price": "1 200 000",
"photos": {
"1": "https://pixeloff.ru/photos/o01_4db6d3c0.../w/",
"2": "https://pixeloff.ru/photos/o01_544c0c26.../f/",
"3": "https://pixeloff.ru/photos/o01_928e13b5.../m/"
},
"balance": "455"
}
Пример использования (PHP)
<?php
ini_set('max_execution_time', '300');
$url = "https://www.avito.ru/..."; // Ссылка на объявление
$pixeloff_key = "MY123KEY"; // Ваш ключ доступа
$maxQuery = 100;
$cnt = 0;
function getPixeloff() {
global $url, $pixeloff_key;
$str = file_get_contents(
"https://pixeloff.ru/api/v2.php?k=$pixeloff_key&u=" . urlencode($url)
);
return json_decode($str);
}
$json = getPixeloff();
sleep(5);
while (!$json->status || ($json->status != 'done' && $json->status != 'error')) {
sleep(3);
$json = getPixeloff();
if ($cnt > $maxQuery) {
die('TimeOut Error!');
} else {
$cnt++;
}
}
if ($json->status == 'done') {
echo $json->title . "<br>";
foreach ($json->photos as $val) {
echo "<img src='$val' height='60'>";
}
}
?>
max_execution_time. Рекомендуем разбить
скрипт на две части: инициирующую обработку и принимающую результаты.
Таблица ошибок
| Код | Описание | Вычет |
|---|---|---|
101 | Не указан ваш ключ, в параметре 'k' | нет |
102 | Не указана ссылка на объявление, в параметре 'u' | нет |
104 | Ключ указанный в параметре 'k' не найден | нет |
105 | Отрицательный баланс ключа | нет |
120 | В параметре 'u' указана некорректная ссылка | нет |
210 | Объявление не найдено | нет |
220 | Не найдены фотографии в объявлении | да |
225 | При обработке фото произошла ошибка | нет |
230 | Объявление более не актуально | да |
250 | Неизвестная ошибка — обратитесь в поддержку | нет |
300 | Превышено количество одновременных обработок | нет |
500 | Технические неполадки. Повторите позднее... | нет |
501 | Технические неполадки с обработкой данного источника | нет |
Важное предупреждение
API предназначен исключительно для автоматизации и упрощения работы с объявлениями тех авторов, которые дали вам согласие на обработку/копирование/размещение принадлежащих им текстовых и фото материалов. Мы против любых нарушений прав владельцев интеллектуальной собственности!
Получая доступ, вы безоговорочно соглашаетесь с пользовательским соглашением, в рамках которого вы не имеете права обрабатывать объявления и цифровые изображения, если вами не было получено согласие их правообладателей!