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

Ключ доступа

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

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

Для отправки данных используется метод POST на следующий URL:
https://unmark.ru/api/<имя метода>
Заголовки для любого запроса к API:
X-Token
Ваш персональный ключ доступа
X-Version
Версия API актуальная версия — 2.0
Сервер возвращает ответ в JSON формате. Пример успешного ответа:
{
	"response": {
		<данные ответа>
	}
}
			
В случае ошибки сервер вернет ответ формата:
{
	"error": {
		"code": <код ошибки>,
		"text": <описание ошибки>,
		"data": [<дополнительные данные>]
	}
}
			

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

public.advert.get

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

public.task.add

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

public.user.balance

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

Коды ошибок

METHOD
Метод недоступен
INPUT
Ошибка входящих данных
PUBLIC_KEY
Неверный ключ доступа
PUBLIC_VERSION
Недоступная версия API
PUBLIC_RUNTIME
Сбой выполнения запроса
TARIFF_LIMIT
Баланс исчерпан
OFTEN
Слишком частое выполнение действия, повторите позднее
NOTFOUND
Не найдено
ADVERT_URL
Неизвестная ссылка
ADVERT_IMAGES
Фотографии не найдены
WORKS
Технические работы, попробуйте позднее
UNKNOWN
Обнаружена проблема, уже исправляем

Примеры

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