Настройка АнтиЗнак API

Ссылка на api:


При первом запросе api, запускается обработка(status=searching) объявления указанного в параметре "u" . При последующих запросах к api с теми же параметрами, обработка уже не инициируется, а просто выводится результат действующей обработки. Пока идёт обработка(удаление водяных знаков с фото), будет возвращаться status=processed, когда обработка завершится status примет значение done и станут доступны ссылки на уже очищенные фото.

Параметры запроса:

k	Ключ доступа	Укажите в данном параметре ваш ключ доступа. Для работы API ключ, должен иметь положительный баланс
u	URL объявления	Ссылка на объявление. Рекомендуется использовать "urlencode".

Данные ответа:

status	string	Статус обработки объявления. searching - поиск объявления processed XX% - идёт процедура обработки всех фотографий объявления от 0 до 100% готовности. done - удаление водяных знаков завершено для всех фото error - возникла ошибка, объявление не обработано
ID	integer	ID объявления на источнике.
api_id	integer	ID объявления AntiZnak.
title	string	Заголовок объявления
address	string	Адрес указанный в объявлении
parameters	array of string	Массив параметров объявления
description	string	Описание из объявления
price	integer	Стоимость указанная в объявлении
photos	array of string	Массив фотографий без водяных знаков.
balance	integer	Ваш баланс(остаток объявлений)

Пример ответа в формате JSON:
{ "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://photu.ru/ph0t0s_o01_4db6d3c02ad90a478d326a3fe1b18185/w/", "2":"https://photu.ru/ph0t0s_o01_544c0c2639ece61a0e33ca53e98a312e/f/", "3":"https://photu.ru/ph0t0s_o01_928e13b5140d6be5e8a7a1d7a1b16fde/m/", "4":"https://photu.ru/ph0t0s_o01_d1fe6272b3e94bbe07197c30dda71a0a/S/", "5":"https://photu.ru/ph0t0s_o01_781622254f13f4115124bd607f0ca21a/V/" }, "balance":"455" }

Пример использования (PHP):
<?php ini_set('max_execution_time', '300'); $url = "https://www.*****.ru/sochi/komnaty/komnata_14442053**"; // Ссылка на объявление $antiznak_key = "MY123KEY"; // Ваш ключ доступа $maxQuery = 100; // Максимальное кол-во запросов, на случай обрыва соединения $cnt = 0; function getantiznak(){ global $url,$antiznak_key; $str = file_get_contents("https://antiznak.ru/api/v2.php?k=$antiznak_key&u=".urlencode($url)); return json_decode($str); } $json = getantiznak(); sleep(5); while (!$json->status || ( $json->status!='done' && $json->status!='error' ) ){ sleep(3); $json = getantiznak(); if ($cnt>$maxQuery) { die('TimeOut Error!'); //ОШИБКА - истекло время ожидания обработки объявления }else{ $cnt++; if ( strpos( $json->status, "%" ) ) //процент выполнения обработки 0-100% $percent = str_replace("processed ","", $json->status); } } if ($json->status=='error') // ЕСЛИ ВОЗНИКЛИ ОШИБКИ { // Вывод на экран echo $json->err_code . "<br>" . $json->text . "<br>" . $json->balance . "<br>"; } if ($json->status=='done') // УСПЕШНАЯ ОБРАБОТКА { // Вывод на экран echo $json->ID . "<br>" . $json->api_id . "<br>" . $json->title . "<br>" . $json->address . "<br>" . $json->description . "<br>" . $json->price . "<br>" . $json->balance . "<br>"; foreach ($json->parameters as $key=>$val) echo "$key: $val<br>"; foreach ($json->photos as $val) echo "<img src='$val' height='60'>"; } ?>
Внимание! Приведённый выше код работает долго!!! Он посылает запрос на обработку объявления и ожидает её полного завершения, посылая повторные запросы по таймеру. Если в объявлении много фотографий - обработка займёт определённое время. В этом случае позаботьтесь о параметре php max_execution_time, иначе скрипт может быть прерван до завершения обработки объявления. Но мы бы порекомендовали разбить скрипт на две части(инициирующая обработку, принимающая результаты) и запускать поразнь.

---

Возможные ошибки:
Если обработка объявления не удалась, то API вернёт следующее: { "status": "error", "err_code": "КОД ОШИБКИ", "text":"Текстовое описание ошибки" "balance":"Ваш баланс" }

КОД Ошибки	Описание	Вычет из баланса
101	Не указан ваш ключ, в параметре `k`	нет
102	Не указана ссылка на объявление, в параметре `u`	нет
104	Ключ указанный в параметре `k` не найден.	нет
105	Отрицательный баланс ключа.	нет
120	В параметре `u` указана не корректная ссылка	нет
210	Объявление не найдено	нет
220	Не найдены фотографии в объявлении	да
225	При обработке фото произошла ошибка	нет
230	Объявление более не актуально	да
250	Неизвестная ошибка - обратитесь в поддержку	нет
500	Технические неполадки. Уже решаем проблему, повторите позднее...	нет
501	Технические неполадки с обработкой данного источника. Уже решаем проблему, повторите позднее...	нет