Фотохостинг / Хостинг картинок

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

Ключ

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

65110c677009afd817b4fd159624cd8c815d2221aee3965734d153e2caf545e0

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

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

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

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

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

https://fotohosting.pro/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://fotohosting.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"
}