# uploadFromUrl

Перед тобой стоит задача, отправить подписчику файл с помощью одного из [API-методов](/api-metody.md). Но для этого тебе нужен UUID файла, где же его взять? Этот метод поможет тебе :)

Ты передаешь ему ссылку на сайт, и тип файла - он загружает его на сервер, и возвращает тебе file\_uuid.

Давай рассмотрим параметры:

## Загружает файл на сервер, используя URL-адрес

<mark style="color:blue;">`GET`</mark> `https://leadconverter.ru/api/v1/токен/file.uploadFromUrl`

#### Query Parameters

| Name                                         | Type   | Description                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| file\_url<mark style="color:red;">\*</mark>  | String | URL-адрес файла, который необходимо загрузить                                                                                                                                                                                                                                                                                            |
| file\_type<mark style="color:red;">\*</mark> | String | <p>Одно из значений: IMAGE, VIDEO, FILE, AUDIO\_MESSAGE.</p><p></p><p>Определяет, как этот файл будет в дальнейшем отправлен пользователю</p><p>IMAGE - изображение</p><p>VIDEO - видео-файл</p><p>FILE - любой файл (если отправить картинку с этой опцией - она будет отправлена как вложение)AUDIO\_MESSAGE - голосовое сообщение</p> |

{% tabs %}
{% tab title="200: OK Возвращает file\_uuid в JSON-формате (см описание) ->" %}

```javascript
{
    "file_uuid":"UUID_загруженного_файла"
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity MIME-тип файла не соответствует file\_type (описание)->" %}

```javascript
// Возникает, если вы по ссылке передали видео, а в file_type указали, 
// что это, например, изображение
{
    "error":"Illegal mime type \"...\" for file type \"...\"",
    "status":422
}
```

{% endtab %}
{% endtabs %}

Итоговый пример запроса:&#x20;

```
https://leadconverter.ru/api/v1/токен/file.uploadFromUrl?file_url=https://img2.akspic.ru/originals/4/8/3/7/5/157384-legkij_cifrovoj_pejzazh_pejzazh-risovanie-zhivopis-cifrovoe_iskusstvo-art-2500x2500.jpg&file_type=IMAGE
```

Если у тебя появились какие-то вопросы - [напиши в поддержку](/kak-zadat-vopros-v-podderzhku.md). &#x20;

Мы будем рады тебе помочь  :)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.leadconverter.su/api-metody/file/uploadfromurl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
