Creative APIDocs
Общее API

Общее API

Ссылка на скачивание файла

Прямая ссылка на файл результата, которая действует 20 минут. Подходит, чтобы отдать файл браузеру или другому сервису без перенаправлений.

POST https://api.cr-api.ru/api/v1/common/download-url

Тело запроса

ПолеОбязательноеЧто это
urlдаСсылка из resultJson.resultUrls задачи: https://files.cr-api.ru/<имя>

Пример запроса

curl -X POST "https://api.cr-api.ru/api/v1/common/download-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://files.cr-api.ru/YOUR_FILE.png"
}'

Ответ

data — прямая ссылка на 20 минут. Файл чужой задачи, удалённый или не наш — code 422, File not found or expired.

Файлы результатов

  • Ссылки на результат — в resultJson.resultUrls задачи: адреса вида https://files.cr-api.ru/<имя>.png.
  • Файлы хранятся 14 дней с момента готовности, затем удаляются. Скачайте их к себе, если они нужны дольше.
  • Ссылка постоянна, пока файл хранится: по ней можно скачивать много раз. Сам файл отдаётся по короткой подписанной ссылке, на которую ведёт перенаправление.
  • Имя файла в ссылке — 128 случайных бит: угадать его нельзя. Передавайте ссылку только тем, кому можно видеть результат.