Подключите свою систему к UNMARK API для автоматической очистки фотографий от водяных знаков

Ключ доступа

Для начала работы с UNMARK API вам нужно получить персональный ключ доступа. Авторизуйтесь на сайте для получения ключа.
Авторизация

Общие сведения

Для отправки данных используется метод GET или POST на следующий URL:
https://unmark.ru/api/
Базовые параметры для любого запроса к API:
method
Имя вызываемого метода
key
Ваш персональный ключ доступа
version
Версия API. По умолчанию: актуальная версия — 1.0
Сервер возвращает ответ в JSON формате. Пример успешного ответа:
{
	"response": {
		<данные ответа>
	}
}
			
В случае ошибки сервер вернет ответ формата:
{
	"error": {
		"id": <номер ошибки>,
		"text": <описание ошибки>,
		"data": [<дополнительные данные>]
	}
}
			

Список методов

public.advert.get

Получить информацию об объявлении. Используется для получения списка фото для дальнейшей обработки.
url
Ссылка на объявление
Пример ответа:
{
	"response": {
		"id": <id объявления>,
		"images": [
			[
				"hash": <хэш фотографии>
			],
			[
				"hash": <хэш фотографии>
			],
			...
		]
	}
}
			

public.task.add

Отправить фотографию из объявления на обработку.
advert_id
id объявления
index
порядковый номер фото в массиве images от 0
hash
хэш фотографии
Пример ответа:
{
	"response": {
		"url": <ссылка на очищенное фото>
	}
}
			

public.user.balance

Получить информацию о текущем балансе аккаунта.
Пример ответа:
{
	"response": {
		"value": <количество доступных фото>,
		"expire": <UNIX-время окончания тарифа>,
		"reset": <UNIX-время сброса дневных лимитов>
	}
}
			

Список ошибок

0
Неизвестная ошибка
1
Метод недоступен
2
Ошибка входящих данных
3
Слишком частое выполнение действия, повторите позднее
20
Технические работы, попробуйте позднее
21
Сбой выполнения запроса
40
Не найдено
101
Баланс исчерпан
120
Неизвестная ссылка
123
Фотографии не найдены
140
Недоступная версия API
141
Неверный ключ доступа

Примеры

Вы можете скачать готовый класс для работы с UNMARK API
PHP