Zum Hauptinhalt springen
POST
/
files
/
v3
/
files
/
import-from-url
/
async
Importer un fichier depuis l'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"
    }
  ]
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubStarter

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • 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 : le fichier est accessible publiquement par quiconque possède l'URL. Les moteurs de recherche peuvent indexer le fichier. PUBLIC_NOT_INDEXABLE : le fichier est accessible publiquement par quiconque possède l'URL. Les moteurs de recherche ne peuvent pas indexer le fichier. PRIVATE : le fichier n'est PAS accessible publiquement. Nécessite une URL signée pour voir le contenu. Les moteurs de recherche ne peuvent pas indexer le fichier.

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

URL pour télécharger le nouveau fichier.

​
folderPath
string

Un folderPath ou folderId est requis. Chemin du dossier de destination pour le fichier chargé. Si le chemin du dossier n'existe pas, une tentative de création du chemin du dossier sera effectuée.

​
duplicateValidationScope
enum<string>

ENTIRE_PORTAL : rechercher un fichier doublon dans l'ensemble du compte. EXACT_FOLDER : rechercher un fichier doublon dans le dossier fourni.

Available options:
ENTIRE_PORTAL,
EXACT_FOLDER
​
name
string

Nommer le fichier résultant dans le gestionnaire de fichiers.

​
duplicateValidationStrategy
enum<string>

NONE : ne pas exécuter de validation de doublon. REJECT : rejeter le chargement si un doublon est trouvé. RETURN_EXISTING : si un fichier doublon est trouvé, ne pas télécharger un nouveau fichier et retourner le doublon trouvé à la place.

Available options:
NONE,
REJECT,
RETURN_EXISTING
​
ttl
string

Durée de vie. Si spécifié, le fichier sera supprimé après le délai indiqué. Si non défini, le fichier existera indéfiniment.

​
overwrite
boolean

Si vrai, le fichier existant sera écrasé s'il en existe un avec le même nom et la même extension dans le dossier donné. Le fichier écrasé sera supprimé et le fichier chargé prendra sa place avec un nouvel identifiant. Si non défini ou défini comme faux, le nom du nouveau fichier sera mis à jour pour éviter tout conflit avec un fichier existant s'il en existe un avec le même chemin, nom et extension.

​
expiresAt
string<date-time>

Spécifie la date et l'heure auxquelles le fichier expirera.

​
folderId
string

Un folderId ou folderPath est requis. folderId de destination pour le fichier chargé.

Response

accepted

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

​
links
object
required

Liens pour vérifier les informations relatives à la tâche. Le lien « statut » donne l'URL pour vérifier le statut de la tâche.

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 tâche

Example:

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

⌘I