загрузите и получите прямую ссылку

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

Ключ

Открытый ключ API

9ad968c87301b6ad7ab4b82dde20d4e80268ed7143658352c6de5aafe0c9b281

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

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

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

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

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

https://fotovssylku.ru/api/1/upload

Авторизация

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://fotovssylku.ru/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"
}