Загрузка файлов через API

Начните с одного запроса

От файла до ссылки

Для загрузки используйте POST и передайте файл в поле source. Ответ по умолчанию приходит в формате JSON.

curl --fail-with-body -X POST https://kar.su/api/1/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "source=@image.jpg" \
  -F "title=Моё изображение"

Замените YOUR_API_KEY своим ключом, а image.jpg — путём к файлу. Пример рассчитан на Bash; в Windows можно использовать WSL.

1. 01Получите ключОткройте раздел API в настройках аккаунта.
2. 02Отправьте файлПередайте ключ в заголовке, а файл — в теле запроса.
3. 03Заберите ссылкуИспользуйте image.url из ответа сервера.

Доступ к API

Ключ и авторизация

Ваш ключ находится в настройках аккаунта → API. Передавайте его в заголовке X-API-Key.

X-API-Key: YOUR_API_KEY

API также принимает GET-запросы и параметр key. Для обычной загрузки рекомендуем POST и заголовок: так ключ не попадает в адрес запроса.

Настройка загрузки

Параметры запроса

Обязателен файл в поле source и действующий ключ. Остальные параметры добавляйте по необходимости.

Результат запроса

Ответ сервера

При успешной загрузке JSON содержит status_code: 200, status_txt: "OK" и объект image. Ниже — сокращённый пример; адреса в нём приведены для иллюстрации.

{
  "status_code": 200,
  "status_txt": "OK",
  "success": { "message": "file uploaded", "code": 200 },
  "image": {
    "title": "Моё изображение",
    "url": "https://kar.su/images/example.jpg",
    "url_viewer": "https://kar.su/image/example"
  }
}

Другие форматы ответа

format=txt возвращает прямую ссылку текстом. format=redirect перенаправляет на страницу загруженного файла.

Быстрая проверка

Если загрузка не прошла