Спецификация

API URL: http://api.imageban.ru/upload_api.php

API URL HTTPS: https://api.imageban.ru/upload_api.php

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

userfile - файл картинки. Должен быть передан как HTTP POST в формате multipart/form-data. Обязательный параметр.

user - Имя пользователя. Обязательное поле.

passwd - Пароль. Обязательное поле.

Последние два поля служат для загрузки изображений в свой профиль.

Все данные скрипт отдаёт в формате XML.

Основные коды ошибок:

100	Invalid account	Неправильные имя пользователя или пароль
101	No image selected	Не выбран файл изображения
102	Image is larger than 10MB	Файл больше допустимых 10Мб
103	Invalid image type	Файл не является файлом изображения
104	Image failed to upload	Содержимое файла испорчено или битое
105	Server is temporarily unavailable	Недоступен сервер для загрузки изображений
106	Only registered users can upload images	Не указаны данные для авторизации

Пример ответа:

<rsp stat="ok">
  <url1>https://i2.imageban.ru/out/2010/07/01/898e2e027b2f969103c36dca4f194c9c.jpg</url1>
  <url2>[URL=https://imageban.ru/show/2010/07/01/898e2e027b2f969103c36dca4f194c9c/jpg]
  [IMG]https://i2.imageban.ru/thumbs/2010.07.01/898e2e027b2f969103c36dca4f194c9c.jpg[/IMG][/URL]</url2>
  <url3>[URL=https://imageban.ru][IMG]http://i2.imageban.ru/out/2010/07/01/898e2e027b2f969103c36dca4f194c9c.jpg[/IMG][/URL]
  </url3>
  <url4>
  https://imageban.ru/show/2010/07/01/898e2e027b2f969103c36dca4f194c9c/jpg
  </url4>
  <url5>
  <a target="_blank" href="https://imageban.ru/show/2010/07/01/898e2e027b2f969103c36dca4f194c9c/jpg">
  <img src="https://i2.imageban.ru/thumbs/2010.07.01/898e2e027b2f969103c36dca4f194c9c.jpg" border="0" style='border: 1px solid #000000'></a>
  </url5>
  <url6>
 http://ibn.im/389f37b754b
  </url6>
</rsp>

Тэг <url1></url1> содержит код "Cсылка на страницу с картинкой"

Тэг <url2></url2> содержит код "Превью - увеличение по клику"

Тэг <url3></url3> содержит код "Оригинальная картинка"

Тэг <url4></url4> содержит код "HTML код превью увеличение по клику"

Тэг <url5> </url5> содержит код "HTML код оригинальная картинка"

Тэг <url6> </url6> содержит код "Короткая ссылка"

Пример ответа с ошибкой:

<rsp stat="fail">
<err code="100" msg="Invalid account"/>
</rsp>

err code - содержит код ошибки в данном случае не правильные логин или пароль.

Пример на HTML для загрузки изображения:

Логин:  Пароль:

Код формы:

<form enctype="multipart/form-data" name="uploadform" id="uploadform" action="http://api.imageban.ru/upload_api.php" method="post">
<input type="file" name="userfile" size="30" class="xz">
<br>
Логин: <input type="text" name="user" id="user" class="btn"/><br />
Пароль: <input type="text" name="passwd" id="passwd" class="btn"><br>
<input type="submit" value="Закачать" name="upload" class="btn" id=b />
<br><br>
</form>

Создание альбомов

Создавать альбомы могут только зарегистрированные пользователи.

Параметры для POST запроса:

user - Имя пользователя. Обязательное поле.

passwd - Пароль. Обязательное поле.

albumname - Название нового альбома. Обязательное поле.

Основные коды ошибок:

107

No album name

Отсутствует название альбома

Пример ответа:

<rsp stat="ok">
<albumid>XXXX</albumid>
</rsp>

Тэг <albumid></albumid> будет содержать ID созданного альбома

Для загрузки изображения в определённый альбом нужно указать его ID

Загрузка изображений в определённый альбом

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

userfile - файл картинки. Должен быть передан как HTTP POST в формате multipart/form-data. Обязательный параметр.

user - Имя пользователя. Обязательное поле.

passwd - Пароль. Обязательное поле.

aid - ID альбома.

Если параметр aid не указан или неверен, то изображение не попадёт в альбом.

Удачных разработок. Также если вы хотите дополнительные функции в API пишите на почту info@imageban.ru.