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 '{
  "access": "HIDDEN_INDEXABLE",
  "duplicateValidationScope": "ENTIRE_PORTAL",
  "duplicateValidationStrategy": "NONE",
  "expiresAt": "2023-11-07T05:31:56Z",
  "folderId": "<string>",
  "folderPath": "<string>",
  "name": "<string>",
  "overwrite": true,
  "ttl": "<string>",
  "url": "<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 Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Starter
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.

Verfügbare Optionen:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
url
string
required

URL pour télécharger le nouveau fichier.

​
duplicateValidationScope
enum<string>

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

Verfügbare Optionen:
ENTIRE_PORTAL,
EXACT_FOLDER
​
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.

Verfügbare Optionen:
NONE,
REJECT,
RETURN_EXISTING
​
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é.

​
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.

​
name
string

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

​
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.

​
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.

Response

accepted

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

​
id
string
required

ID de la tâche

​
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.