Skip to main content
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Importar archivo desde URL
curl --request POST \
  --url https://api.hubapi.com/files/v3/files/import-from-url/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "folderPath": "<string>",
  "access": "PUBLIC_INDEXABLE",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "name": "<string>",
  "duplicateValidationStrategy": "NONE",
  "ttl": "<string>",
  "overwrite": true,
  "expiresAt": "2023-11-07T05:31:56Z",
  "url": "<string>",
  "folderId": "<string>"
}'
{
  "id": "57122e26-59f8-4cfc-ba53-96e30c816762",
  "links": [
    {
      "status": "https://api.hubspot.com/files/v3/files/import-from-url/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status"
    }
  ]
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubStarter

​
Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • files

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
access
enum<string>
required

PUBLIC_INDEXABLE: el archivo es públicamente accesible para cualquiera que tenga la URL. Los motores de búsqueda pueden indexar el archivo. PUBLIC_NOT_INDEXABLE: el archivo es públicamente accesible para cualquiera que tenga la URL. Los motores de búsqueda no pueden indexar el archivo. PRIVATE: el archivo NO es públicamente accesible. Requiere una URL firmada para ver el contenido. Los motores de búsqueda no pueden indexar el archivo.

Available options:
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
PRIVATE,
HIDDEN_SENSITIVE,
SENSITIVE
​
url
string
required

URL para descargar el nuevo archivo.

​
folderPath
string

Se requiere folderPath o folderId. Ruta de la carpeta de destino para el archivo cargado. Si la ruta de la carpeta no existe, se intentará crearla.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL: Buscar un archivo duplicado en toda la cuenta. EXACT_FOLDER: Buscar un archivo duplicado en la carpeta proporcionada.

Available options:
ENTIRE_PORTAL,
EXACT_FOLDER
​
name
string

Nombre que se dará al archivo resultante en el administrador de archivos.

​
duplicateValidationStrategy
enum<string>

NONE: No ejecutar ninguna validación de duplicados. REJECT: Rechazar la carga si se encuentra un duplicado. RETURN_EXISTING: Si se encuentra un archivo duplicado, no cargar un archivo nuevo y devolver el duplicado encontrado en su lugar.

Available options:
NONE,
REJECT,
RETURN_EXISTING
​
ttl
string

Tiempo de vida. Si se especifica, el archivo se eliminará una vez transcurrido el período indicado. Si no se especifica, el archivo existirá indefinidamente.

​
overwrite
boolean

Si es verdadero, sobrescribirá el archivo existente si uno con el mismo nombre y extensión existe en la carpeta dada. El archivo sobrescrito se eliminará y el archivo cargado ocupará su lugar con un nuevo ID. Si no se establece o se establece como falso, el nombre del nuevo archivo se actualizará para evitar la colisión con el archivo existente si existe uno con la misma ruta, nombre y extensión.

​
expiresAt
string<date-time>

Specifies the date and time when the file will expire.

​
folderId
string

Se requiere folderId o folderPath. Parámetro folderId de destino para el archivo cargado.

Response

accepted

Information on the task that has been started, and where to check it's status.

​
links
object
required

Enlaces para consultar información relacionada con la tarea. El enlace "status" proporciona la URL para comprobar el estado de la tarea.

Example:

"[{\"status\":\"https://api.hubspot.com/files/v3/files/import-from-url/async/tasks/57122e26-59f8-4cfc-ba53-96e30c816762/status\"}]"

​
id
string
required

ID de la tarea

Example:

"57122e26-59f8-4cfc-ba53-96e30c816762"

⌘I