API версии 1.1
Наше API является доработаной версией Chevereto API v1 и поддерживает кроме функции upload еще и функции работы с картинками и альбомами: создание альбома, удаление альбома, изменение альбома, изменение информации о картинке, перенос в другой альбом, удаление картинки
Ключ АПИ
На данный момент ключем является: 8fda0f020c89a1fe53d117deef24ab03
Все функции, кроме аплоада, требуют идентификации пользователя с помощью логина и пароля. Для картинки, что загружены без указания логина и пароля, остальные функции API не поддерживаются
API вызовы
Метод запроса
API работает с POST и GET запросами, но предпочтительным методом является POST
Запрашиваемый URL
http://mysite.com/api/1/<action>/
Параметры
Общими параметрами для всех функций являются:
- key - ключ* (8fda0f020c89a1fe53d117deef24ab03)
- login - логин
- password - пароль
- format - формат ответа: json (используется по умолчанию), redirect, txt
- image_id - Закодированое ID картинки
- image_description - описание картинки
- image_title - заголовок картинки
- album_id - Закодированое ID альбома
- album_name - название альбома
- album_privacy - параметры доступа к альбому (private, public, private_but_link)
- album_description - описание альбома
- new_album - флаг, если при апдейте картинки нужно ее перенести в новый альбом
- source - источник картинки: может быть base64 кодом картинки, файлом или URL
- width - ширина картинки (будет использован ресайз)
- height - высота картинки (будет использован ресайз)
- thumb_width - ширина превью
- thumb_height - высота превью
- expiration - период хранения картинки (если не указан используются настройки аккаунта). Формат: PT[M|H] для часов или минут, PD для дней
- description - описание картинки
- name - заголовок картинки
Операции
UPLOAD
Описание: Команда отвечает за загрузку картинок
Параметры: source, width, height, thumb_width, thumb_height, expiration, description, name
Пример:
http://lostpic.net/api/1/upload/?key=8fda0f020c89a1fe53d117deef24ab03&source=https://ahnames.com/www/flat.skin/images/banner/afilias/en.jpg&login=login&password=password&format=json
Ответ:
{
"status_code": 200,
"success":
{
"message": "image uploaded",
"code": 200
},
"image":
{
"name": "99928198fe174597188667fd9e5bbd6a",
"extension": "jpg",
"size": 249438,
"width": "2400",
"height": "460",
"date": "2017-02-17 17:56:25",
"date_gmt": "2017-02-17 14:56:25",
"title": "En",
"description": null,
"nsfw": "0",
"storage_mode": "datefolder",
"md5": "2ea531c369ccad95cd7e37136ecd10d5",
"original_filename": "en.jpg",
"original_exifdata": "{\"FileName\":\"en.jpg\",\"FileDateTime\":\"1487343385\",\"FileSize\":\"249438\",\"FileType\":\"2\",\"MimeType\":\"image/jpeg\",\"SectionsFound\":\"IFD0, APP12\",\"COMPUTED\":{\"html\":\"width=\"2400\" height=\"460\"\",\"Height\":\"460\",\"Width\":\"2400\",\"IsColor\":\"1\",\"ByteOrderMotorola\":\"0\"},\"Company\":\"Ducky\",\"Info\":\"\u0001\"}",
"views": "0",
"category_id": null,
"chain": "7",
"thumb_size": "21733",
"medium_size": "93254",
"expiration_date_gmt": null,
"likes": "0",
"site_id": "1",
"file":
{
"resource":
{
"type": "url",
"chain":
{
"image": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.jpg",
"thumb": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.th.jpg",
"medium": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.md.jpg"
}
}
},
"id_encoded": "Qjw0",
"filename": "99928198fe174597188667fd9e5bbd6a.jpg",
"mime": "image/jpeg",
"url": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.jpg",
"ratio": 5.2173913043478,
"size_formatted": "249.4 KB",
"url_viewer": "http://lostpic.net/image/Qjw0",
"image":
{
"filename": "99928198fe174597188667fd9e5bbd6a.jpg",
"name": "99928198fe174597188667fd9e5bbd6a",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.jpg",
"size": 249438
},
"thumb":
{
"filename": "99928198fe174597188667fd9e5bbd6a.th.jpg",
"name": "99928198fe174597188667fd9e5bbd6a.th",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.th.jpg",
"size": "21733"
},
"medium":
{
"filename": "99928198fe174597188667fd9e5bbd6a.md.jpg",
"name": "99928198fe174597188667fd9e5bbd6a.md",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.md.jpg",
"size": "93254"
},
"display_url": "http://img11.lostpic.net/2017/02/17/99928198fe174597188667fd9e5bbd6a.md.jpg",
"display_width": "2400",
"display_height": "460",
"views_label": "просмотров",
"likes_label": "понравилось",
"how_long_ago": "минут назад",
"title_truncated": "En",
"title_truncated_html": "En"
},
"status_txt": "OK"
}
MOVE
Описание: Команда отвечает за изменение картинок
Параметры: image_id, image_description, image_title, album_id, new_album, album_name, album_privacy, album_description
Пример:
http://lostpic.net/api/1/move/?key=8fda0f020c89a1fe53d117deef24ab03&image_id=QjUk&image_description=new_description&image_title=new%20title&new_album=true&album_name=new_private_album&album_privacy=private&album_description=new%20album%20description&login=login&password=password
Ответ:
{
"status_code": 200,
"image":
{
"name": "d5a939b4db945d4261b563b3866b23cd",
"extension": "jpg",
"size": 249438,
"width": "2400",
"height": "460",
"date": "2017-02-17 17:59:25",
"date_gmt": "2017-02-17 15:59:25",
"title": "new title",
"description": "new_description",
"nsfw": "0",
"storage_mode": "datefolder",
"md5": "2ea531c369ccad95cd7e37136ecd10d5",
"original_filename": "en.jpg",
"original_exifdata": "{\"FileName\":\"en.jpg\",\"FileDateTime\":\"1487347164\",\"FileSize\":\"249438\",\"FileType\":\"2\",\"MimeType\":\"image/jpeg\",\"SectionsFound\":\"IFD0, APP12\",\"COMPUTED\":{\"html\":\"width=\"2400\" height=\"460\"\",\"Height\":\"460\",\"Width\":\"2400\",\"IsColor\":\"1\",\"ByteOrderMotorola\":\"0\"},\"Company\":\"Ducky\",\"Info\":\"\u0001\"}",
"views": "0",
"category_id": null,
"chain": "7",
"thumb_size": "21733",
"medium_size": "93254",
"expiration_date_gmt": null,
"likes": "0",
"site_id": "1",
"album":
{
"name": "new_private_album",
"user_id": "3101",
"date": "2017-02-17 19:25:03",
"date_gmt": "2017-02-17 16:25:03",
"privacy": "private",
"image_count": "1",
"description": "new album description",
"creation_ip": "88.208.49.147",
"likes": "0",
"id_encoded": "y8",
"url": "http://lostpic.net/album/y8"
},
"like":
{
"id": null,
"date": null,
"date_gmt": null,
"user_id": null,
"content_type": null,
"content_id": null,
"content_user_id": null,
"ip": null
},
"liked": false,
"file":
{
"resource":
{
"type": "url",
"chain":
{
"image": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.jpg",
"thumb": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.th.jpg",
"medium": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.md.jpg"
}
}
},
"id_encoded": "QjUk",
"filename": "d5a939b4db945d4261b563b3866b23cd.jpg",
"mime": "image/jpeg",
"url": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.jpg",
"ratio": 5.2173913043478,
"size_formatted": "249.4 KB",
"url_viewer": "http://lostpic.net/image/QjUk",
"image":
{
"filename": "d5a939b4db945d4261b563b3866b23cd.jpg",
"name": "d5a939b4db945d4261b563b3866b23cd",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.jpg",
"size": 249438
},
"thumb":
{
"filename": "d5a939b4db945d4261b563b3866b23cd.th.jpg",
"name": "d5a939b4db945d4261b563b3866b23cd.th",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.th.jpg",
"size": "21733"
},
"medium":
{
"filename": "d5a939b4db945d4261b563b3866b23cd.md.jpg",
"name": "d5a939b4db945d4261b563b3866b23cd.md",
"mime": "image/jpeg",
"extension": "jpg",
"url": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.md.jpg",
"size": "93254"
},
"display_url": "http://img11.lostpic.net/2017/02/17/d5a939b4db945d4261b563b3866b23cd.md.jpg",
"display_width": "2400",
"display_height": "460",
"views_label": "просмотров",
"likes_label": "понравилось",
"how_long_ago": "25 минут назад",
"title_truncated": "new title",
"title_truncated_html": "new title"
},
"success":
{
"message": "image updated",
"code": 200
},
"status_txt": "OK"
}
DELETE
Описание: Команда отвечает за удаление картинок
Параметры: image_id
Пример:
http://lostpic.net/api/1/delete/?key=8fda0f020c89a1fe53d117deef24ab03&image_id=Qyf9&login=login&password=password
Ответ:
{
"status_code": 200,
"success":
{
"message": "image deleted",
"code": 200
},
"status_txt": "OK"
}
CREATE
Описание: Команда отвечает за создание альбомов
Параметры: album_name, album_privacy, album_description
Пример:
http://lostpic.net/api/1/create/?key=8fda0f020c89a1fe53d117deef24ab03&album_name=new album&login=login&password=password
Ответ:
{
"album":
{
"id": "1206",
"name": "new album",
"date": "2017-02-17 19:53:54",
"date_gmt": "2017-02-17 16:53:54",
"privacy": "public",
"privacy_extra": null,
"image_count": "0",
"description": null,
"creation_ip": "88.208.49.147",
"likes": "0",
"id_encoded": "yJ",
"url": "http://lostpic.net/album/yJ",
"how_long_ago": "минут назад"
},
"status_code": 200,
"status_txt": "OK",
"success":
{
"message": "Album created",
"code": 200
},
"creating":
{
"id": "yJ"
},
"id": "yJ"
}
UPDATE
Описание: Команда отвечает за изменение альбома
Параметры: album_id, album_name, album_privacy, album_description
Пример:
http://lostpic.net/api/1/update/?key=8fda0f020c89a1fe53d117deef24ab03&album_name=new album album&album_privacy=public&album_description=new%20album%20description 1111&album_id=y8&login=password&password=password
Ответ:
{
"album":
{
"id": "1203",
"name": "new album album",
"date": "2017-02-17 19:25:03",
"date_gmt": "2017-02-17 16:25:03",
"privacy": "public",
"privacy_extra": null,
"image_count": "0",
"description": "new album description 1111",
"creation_ip": "88.208.49.147",
"likes": "0",
"id_encoded": "y8",
"url": "http://lostpic.net/album/y8",
"how_long_ago": "6 минут назад"
},
"status_code": 200,
"status_txt": "OK",
"success":
{
"message": "Album updated",
"code": "200"
},
"updateting":
{
"id": "y8"
},
"id": "y8"
}
DROP
Описание: Команда отвечает за удаление альбома (альбом удалиться с картинками, что в нем содержаться)
Параметры: album_id
Пример:
http://lostpic.net/api/1/drop/?key=key&album_id=y8&login=login&password=password
Ответ:
{
"status_code": 200,
"status_txt": "OK",
"success":
{
"message": "Album deleted",
"code": 200
},
"deleting":
{
"id": "y8"
},
"id": "y8"
}