Image upload & direct links

Наш API обеспечивает программную загрузку файлов, что позволяет вам легко интегрировать наши функции загрузки в ваши собственные приложения.

Key

Получите свой собственный API-ключ в соответствии с вашими настройками.

Способ запроса

Вызовы API версии 1 могут быть выполнены с использованием методов запроса POST или GET.

Рекомендуется использовать метод POST-запроса.

Запрос URL-адреса

https://imgtourl.pro/api/1/upload

Autoризация

API версии 1.1 поддерживает авторизацию заголовка путем передачи заголовка X-API-Key с ключом API.

X-API-Key: chv_key_here

Параметры

source

Двоичный файл, данные base64 или URL-адрес изображения.

key (optional)

Ключ API. Вы можете использовать этот параметр, если не можете предоставить аутентификацию через заголовки.

title (optional)

Название файла. Если оно не указано, оно автоматически определяется по метаданным.

description (optional)

Описание файла. Это автоматически определяется по метаданным, если не указано иное.

tags (optional)

Теги файлов. Список тегов, разделенных запятыми.

album_id (optional)

Идентификатор файла альбома должен принадлежать пользователю ключа API.

category_id (optional)

Идентификатор категории. Определяет категорию файла для присвоения.

width (optional)

Цель изменит размер по ширине, автоматически определит высоту.

expiration (optional)

Время истечения для автоматического удаления файла в dateintervalformat. Например, PT5M в течение пяти минут в будущем. P3D в течение трех дней в будущем.

nsfw (optional)

Флаг "Небезопасно для работы" [0, 1].

format (optional)

Возвращаемый формат [json, redirect, txt].

use_file_date (optional, admin only)

Настройте использование даты получения файла (Exif) вместо даты загрузки [0, 1].

Пример вызова

curl --fail-with-body -X POST \
	-H "X-API-Key: YOUR_API_KEY" \
	-H "Content-Type: multipart/form-data" \
	-F "source=@image.jpeg" \
	https://imgtourl.pro/api/1/upload

Ответ API

Ответы API версии 1 будут отличаться в зависимости от параметра формата (json, txt, redirect). При использовании JSON (по умолчанию) выходные данные ответа будут содержать свойства status_txt и status_code

Пример ответа (JSON)

{
  "status_code": 200,
  "success": {
    "message": "file uploaded",
    "code": 200
  },
  "image": {
    "name": "Badgers-animated-music-video",
    "extension": "mp4",
    "size": 3011299,
    "width": 496,
    "height": 360,
    "date": "2024-10-10 16:58:00",
    "date_gmt": "2024-10-10 19:58:00",
    "title": "Badgers animated music video MrWeebl",
    "tags": [],
    "description": null,
    "nsfw": 0,
    "storage_mode": "datefolder",
    "md5": "7a120d5c28de264bdbb934f023a628fd",
    "source_md5": null,
    "original_filename": "Badgers _ animated music video _ MrWeebl.mp4",
    "original_exifdata": null,
    "views": 0,
    "category_id": null,
    "chain": 21,
    "thumb_size": 21212,
    "medium_size": 0,
    "frame_size": 19804,
    "expiration_date_gmt": "2024-10-10 20:28:00",
    "likes": 0,
    "is_animated": 0,
    "is_approved": 1,
    "is_360": 0,
    "duration": 73,
    "type": "video",
    "tags_string": "",
    "file": {
      "resource": {
        "type": "url"
      }
    },
    "id_encoded": "ZfGd",
    "filename": "Badgers-animated-music-video.mp4",
    "mime": "video/mp4",
    "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4",
    "ratio": 1.3777777777777778,
    "size_formatted": "3 MB",
    "frame": {
      "filename": "Badgers-animated-music-video.fr.jpeg",
      "name": "Badgers-animated-music-video.fr",
      "mime": "image/jpeg",
      "extension": "jpeg",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
      "size": 19804
    },
    "image": {
      "filename": "Badgers-animated-music-video.mp4",
      "name": "Badgers-animated-music-video",
      "mime": "video/mp4",
      "extension": "mp4",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4",
      "size": 3011299
    },
    "thumb": {
      "filename": "Badgers-animated-music-video.th.jpeg",
      "name": "Badgers-animated-music-video.th",
      "mime": "image/jpeg",
      "extension": "jpeg",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.th.jpeg",
      "size": 21212
    },
    "url_frame": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
    "medium": {
      "filename": null,
      "name": null,
      "mime": null,
      "extension": null,
      "url": null
    },
    "duration_time": "01:13",
    "url_viewer": "http://localhost/clip/Badgers-animated-music-video-MrWeebl.ZfGd",
    "path_viewer": "/clip/Badgers-animated-music-video-MrWeebl.ZfGd",
    "url_short": "http://localhost/clip/ZfGd",
    "display_url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
    "display_width": 496,
    "display_height": 360,
    "views_label": "views",
    "likes_label": "likes",
    "how_long_ago": "moments ago",
    "date_fixed_peer": "2024-10-10 19:58:00",
    "title_truncated": "Badgers animated music vi...",
    "title_truncated_html": "Badgers animated music vi...",
    "is_use_loader": false,
    "display_title": "Badgers animated music video MrWeebl",
    "delete_url": "http://localhost/clip/ZfGd/delete/e8b07479818bc58d3b9849c431e9c2b28827ccce7809ed4f"
  },
  "status_txt": "OK"
}

Пример ответа (text)

http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4

Пример ответа (redirect)

Location: /clip/Badgers-animated-music-video-MrWeebl.ZfGd

API version 1.1

Key