Créer une nouvelle Assembly

Crée une Assembly à partir de fichiers téléversés et d’Assembly Instructions.

POSThttps://api2.transloadit.com/assemblies

Déroulement type :

Envoyez l’exemple de requête ci-dessous avec votre fichier et vos Instructions de traitement. Pour recevoir le statut final via un webhook, incluez notify_url dans ces Instructions avant d’envoyer la requête.
Gardez secrète l’URL assembly_ssl_url renvoyée. Utilisez-la pour suivre la progression, ou attendez le webhook que vous avez configuré.
Attendez ok: "ASSEMBLY_COMPLETED" avant d’utiliser les fichiers traités. Une error ou une annulation ne constitue pas un traitement réussi. Les fichiers de sortie sont regroupés par nom de Step dans results ; consultez les champs de la réponse.

Les Assemblies qui utilisent /transloadit/import, directement ou via un Template, nécessitent soit un jeton porteur, soit des params signés avec un horodatage params.auth.expires situé dans le futur. Cela s’applique même lorsque la Signature Authentication du Workspace est désactivée. Une Auth Key seule ne suffit pas ; les requêtes authentifiées par jeton porteur n’ont pas besoin d’une signature ni d’une expiration distinctes.

Une Assembly peut traiter et exporter des fichiers. Les Assembly Instructions déterminent la manière dont nous devons les traiter. Les Instructions peuvent être transmises directement (dans un paramètre steps), ou être enregistrées dans un Template (référencé dans un paramètre template_id). Les Templates vous permettent de réutiliser des Instructions, de les faire évoluer sans déployer votre application, et de n’exposer aucun secret là où votre application est déployée.

Nous acceptons les requêtes POST multipart/form-data afin de prendre en charge les téléversements classiques via <form> vers notre service (ainsi que l’utilisation via XHR / SDK).

Plusieurs fichiers peuvent être inclus dans cette requête. Si vous souhaitez effectuer des téléversements de fichiers avec reprise, les fichiers ne sont pas inclus dans cette requête, comme décrit dans Téléversements avec reprise.

Note

Transloadit prend en charge des fichiers d’une taille maximale de 200 GB. Si votre application nécessite une limite plus élevée, veuillez nous contacter.

Exemple de requête

Exécutez cette requête dans un shell côté serveur disposant de curl et d’un jeton porteur approprié dans TRANSLOADIT_TOKEN. Si vous avez besoin d’un jeton, dépliez la configuration ci-dessous.

Placez votre fichier d’entrée dans ./example.jpg avant d’exécuter la requête.

Besoin d’un jeton porteur ?

Dans un shell côté serveur de confiance disposant de curl et de jq, définissez TRANSLOADIT_KEY et TRANSLOADIT_SECRET avec votre Auth Key et votre Auth Secret. Gardez secrètes ces deux informations d’identification ainsi que le jeton obtenu ; n’exécutez jamais cette configuration dans du code côté navigateur.

Commencez par créer un jeton avec les portées requises par ce point de terminaison. Votre Auth Key doit déjà accorder ces portées.

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=assemblies:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

Gardez ce shell ouvert et exécutez la requête ci-dessous. Réutilisez le jeton tant qu’il reste valide.

curl --fail-with-body -sS --request POST \
  --url "https://api2.transloadit.com/assemblies" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --form-string 'params={"steps":{"resize":{"robot":"/image/resize","use":":original","width":320}}}' \
  --form 'file=@./example.jpg'

Ce qui se passe ensuite

Une réponse HTTP réussie signifie que l’Assembly est acceptée ; elle ne signifie pas que le traitement est terminé. Une réponse initiale peut ressembler à ceci (extrait ; les ID et les URL seront différents) :

{
  "ok": "ASSEMBLY_EXECUTING",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "results": {}
}

Copiez assembly_ssl_url depuis votre réponse et vérifiez son statut toutes les quelques secondes, ou utilisez un webhook configuré avant la création. Gardez cette URL secrète. Arrêtez-vous en cas d’error ou d’annulation ; aucun des deux ne constitue un traitement réussi.

Lorsque ok vaut ASSEMBLY_COMPLETED, la sortie de cet exemple se trouve dans results.resize. Une réponse terminée inclut les champs suivants (extrait ; l’URL de sortie est donnée à titre d’illustration) :

{
  "ok": "ASSEMBLY_COMPLETED",
  "message": "The Assembly was successfully completed.",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "results": {
    "resize": [
      {
        "name": "example.jpg",
        "mime": "image/jpeg",
        "ssl_url": "https://example.com/temporary-output/example.jpg",
        "meta": {
          "width": 320
        }
      }
    ]
  }
}

Utilisez results.resize[0].ssl_url pour télécharger l’image redimensionnée. Ces URL de sortie temporaires expirent ; ajoutez un Step d’export tel que /s3/store (English) si vous devez conserver les fichiers.

Authentification

Ce point de terminaison accepte des params signés ou un jeton porteur. Consultez la section Authentification pour les instructions de configuration.

Portée requise pour l’Auth Key ou le jeton porteur : assemblies:write.

Les requêtes authentifiées par clé nécessitent une signature lorsque Signature Authentication est activée. Les jetons porteurs ne nécessitent pas de signature distincte.

Paramètres de requête facultatifs pour la réponse

callback (Nom de la fonction de rappel JavaScript). Encapsule les réponses JSON dans une fonction de rappel JSONP. Le nom de la fonction de rappel doit correspondre à ^(?:_jqjsp[0-9]*|jQuery[0-9]+_[0-9]+)$. Seule la dernière occurrence est utilisée ; une valeur vide est ignorée. Les noms de fonction de rappel invalides renvoient le statut HTTP 403. La réponse transformée utilise le statut HTTP 200. La fonction de rappel est appliquée après la sérialisation de la réponse.

Champs de formulaire multipart

Type de contenu : multipart/form-data

params (Chaîne JSON), obligatoire. Un objet encodé en JSON dont les clés prises en charge sont répertoriées ci-dessous.
signature (chaîne de caractères). Obligatoire lorsque la requête utilise Signature Authentication.
num_expected_upload_files (champ de formulaire). Lors de l’utilisation de téléversements avec reprise, ce paramètre indique le nombre de fichiers qui seront téléversés. Vous trouverez plus de détails dans Téléversements avec reprise.
tus_num_expected_upload_files (champ de formulaire). Alias historique de num_expected_upload_files, conservé pour la compatibilité avec les anciens SDK.
* (binaire ou chaîne de caractères). Les fichiers binaires et les champs supplémentaires d’une Assembly peuvent utiliser des noms de champs arbitraires.

Clés prises en charge dans le champ `params`

Les champs d’authentification de cette liste s’appliquent aux requêtes signées. Avec un jeton porteur, vous pouvez omettre params.auth et le champ distinct signature. Comparez les paramètres de requête spécifiques à l’authentification ci-dessous.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Paramètres signés utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

Champ	Type et description
`params.auth` obligatoire pour les requêtes signées ; facultatif avec un jeton porteur	`object` Métadonnées d’authentification et contraintes de téléversement pour une requête d’Assembly signée. La clé d’API est obligatoire. Contient au minimum votre Auth Key Transloadit dans la propriété `key`. Si vous activez Signature Authentication, vous devez également définir une date d’expiration pour la requête dans la propriété expires : `{ "key": "23c96d084c744219a2ce156772ec3211", "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP" }` Nous vous recommandons vivement d’inclure une valeur `params.nonce` générée aléatoirement pour chaque requête, au niveau supérieur de `params`. Ainsi, les signatures générées indépendamment sont distinctes, ce qui évite toute réutilisation accidentelle d’une signature. Un `nonce` ne rend pas les nouvelles tentatives idempotentes : relancer une requête de création d’Assembly peut créer une autre Assembly. Si nécessaire, gérez la déduplication des nouvelles tentatives dans votre application. Ne réutilisez pas des `params` signés d’un point de terminaison à l’autre. La lecture de Templates, le listage des Auth Keys, le listage des informations d’identification de Template et les lectures de facturation rejettent avec `SIGNATURE_REUSE_DETECTED` les signatures déjà enregistrées pour un autre point de terminaison ou utilisées pour créer une Assembly. Générez de nouveaux paramètres signés pour chaque requête. `{ "auth": { "key": "23c96d084c744219a2ce156772ec3211", "expires": "YOUR_FUTURE_ISO_8601_TIMESTAMP" }, "nonce": "04ac6cb6-df43-41fb-a7fd-e5dd711a64e1" }` La propriété `referer` est une expression régulière à comparer à l’en-tête HTTP Referer de ce téléversement, par exemple `"example\.org"`. Utilisez-la pour vérifier les valeurs Referer fournies par rapport à un domaine attendu. Les téléversements sans referer passent toujours (car il est désactivé dans certains navigateurs), si bien que cette propriété n’est utile que dans une poignée de cas d’usage. Pour en savoir plus sur les expressions régulières, consultez la documentation RegExp de Mozilla. Les expressions régulières invalides et les expressions qui dépassent la limite de temps d’évaluation sont rejetées. Cette vérification ne remplace pas Signature Authentication : les clients peuvent omettre ou falsifier l’en-tête Referer. La propriété `max_size` limite la taille totale de téléversement attendue pour l’Assembly, en octets, par exemple `1048576` (1 MB), et non la taille de chaque fichier séparément. Cela inclut le corps de la requête multipart, ou les octets de la requête initiale de l’Assembly plus ses téléversements avec reprise. Le dépassement de la limite arrête l’ensemble de l’Assembly avec une erreur, y compris pour les fichiers qui, individuellement, respectent la limite. Ne comptez pas sur cette limite pour rejeter chaque transfert trop volumineux avant qu’il ne commence. Pour les téléversements avec reprise, la taille déclarée ou reçue devient disponible via les mises à jour tus, et l’Assembly vérifie la limite lorsqu’un téléversement terminé est traité. La taille d’un téléversement différé n’est pas connue à la création, et des octets peuvent déjà avoir été transférés avant que l’Assembly ne le rejette. Si vous souhaitez simplement ignorer les fichiers qui dépassent une certaine taille tout en traitant tous les autres, utilisez 🤖/file/filter (English). La propriété `max_number_of_files` permet de définir le nombre maximal de fichiers que peut comporter un téléversement, par exemple `100`. Indiquez-la pour empêcher les utilisateurs de téléverser un nombre excessif de fichiers, que ce soit par téléversement de fichiers ou via des Robots d’importation. Ces propriétés peuvent être définies dans la requête d’Assembly ou dans le Template. `params.auth`: Seuls les champs répertoriés pour cet objet sont acceptés.
`params.auth.expires`	`string` Horodatage d’expiration au format ISO 8601 situé dans le futur. Obligatoire lorsqu’une requête est signée ou nécessite Signature Authentication ; les requêtes authentifiées par jeton porteur peuvent l’omettre.
`params.auth.key` obligatoire	`string` Clé API Transloadit utilisée pour authentifier les requêtes
`params.auth.max_number_of_files`	`integer` (minimum : 1) Nombre maximal de fichiers d’entrée autorisés par Assembly. Si le nombre de fichiers téléversés ou importés dépasse cette limite, l’Assembly sera arrêtée avec une erreur. Cette limite est utile pour prévenir les abus lorsque les informations d’authentification de Signature Authentication sont exposées.
`params.auth.max_size`	`number` Taille totale maximale attendue du téléversement pour l’Assembly, en octets, y compris la surcharge liée au corps de la requête. Il ne s’agit pas d’une limite par fichier et cela ne garantit pas le rejet avant le début d’un transfert pouvant être repris.
`params.auth.referer`	`string` Expression régulière appliquée à un en-tête HTTP Referer fourni. Les expressions non valides et celles qui dépassent la limite de temps d’évaluation sont rejetées. Les requêtes sans en-tête Referer passent cette vérification ; utilisez Signature Authentication pour authentifier les requêtes.
`params.emit_execution_progress`	`boolean` Définissez ce paramètre sur true pour publier en temps réel des événements Assembly Execution Progress. Ce paramètre est ignoré pour les Assemblies URL Transform.
`params.exiftool_stack`	`string` Sélectionne la pile ExifTool pour l’extraction des métadonnées dans cette Assembly. Cela ne sélectionne pas la pile de traitement des Steps de Robot.
`params.ffmpeg_stack`	`string` Sélectionne la pile FFmpeg pour l’extraction des métadonnées dans cette Assembly. Ce paramètre ne sélectionne pas la pile de traitement des Steps de Robot. Définissez `ffmpeg_stack` sur le Step de Robot concerné pour sélectionner sa pile de traitement.
`params.fields`	`object` Un objet de valeurs associées à des clés de type chaîne (nom -> valeur), qui peuvent être utilisées comme Assembly Variables, tout comme des champs de formulaire supplémentaires. Vous pouvez utiliser comme valeur tout élément sérialisable en JSON Schéma de la propriété supplémentaire `n’importe quelle valeur`
`params.imagemagick_stack`	`string` Sélectionne la pile ImageMagick pour l’extraction des métadonnées dans cette Assembly. Cela ne sélectionne pas la pile de traitement des Steps de Robot. Définissez `imagemagick_stack` sur le Step de Robot concerné pour sélectionner sa pile de traitement.
`params.mediainfo_stack`	`string` Sélectionne la pile MediaInfo pour l’extraction des métadonnées dans cette Assembly. Cela ne sélectionne pas la pile de traitement des Steps de Robot.
`params.mplayer_stack`	`string` Sélectionne la pile MPlayer pour l’extraction des métadonnées dans cette Assembly. Cela ne sélectionne pas la pile de traitement des Steps de Robot.
`params.nonce`	`string \| number` Valeur unique et aléatoire incluse dans les paramètres de la requête signée pour rendre chaque signature unique et empêcher la réutilisation accidentelle d’une signature.
`params.notification_payload`	`Array<"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads">` Contrôle la taille de la charge utile envoyée dans les Assembly Notifications. Les renvois de Notifications réutilisent les filtres fournis dans la requête initiale de l’Assembly ; les filtres définis uniquement dans un Template ne sont pas conservés lors du renvoi. Un tableau vide (valeur par défaut) envoie l’intégralité de l’Assembly Status. Ajoutez `"without_params"` pour que les champs bruts de premier niveau des Assembly Instructions `params`, `template` et `merged_params` soient omis. Ajoutez `"without_result_meta_data"` pour que `meta` soit omis de chaque fichier dans `results`. Ajoutez `"without_results"` pour que l’objet de premier niveau `results` soit omis. Ajoutez `"without_upload_meta_data"` pour que `meta` soit omis de chaque fichier dans `uploads`. Ajoutez `"without_uploads"` pour que le tableau de premier niveau `uploads` soit omis. Le filtrage est appliqué avant la sérialisation, donc l’utilisation de ces options réduit la consommation de mémoire et aide à éviter les échecs dus à une charge utile trop volumineuse ou à un manque de mémoire (OOM) pour les Assemblies volumineuses. Schéma d’un élément de tableau `"without_params" \| "without_result_meta_data" \| "without_results" \| "without_upload_meta_data" \| "without_uploads"`
`params.notify_url`	`null \| string` Transloadit peut envoyer un pingback à votre serveur lorsque l’Assembly est terminée. Nous enverrons l’Assembly Status sous forme de chaîne JSON dans le champ `transloadit` d’une requête POST `application/x-www-form-urlencoded` à l’URL fournie ici. Utilisez `notification_payload` pour réduire la taille de la charge utile (par exemple, `without_uploads`, `without_results`, `without_params`). Les renvois de Notifications ne réutilisent que les filtres fournis dans la requête initiale de l’Assembly, et non les filtres définis uniquement dans un Template.
`params.quiet`	`boolean` Définissez ce paramètre sur true pour réduire au minimum la réponse initiale à la création de l’Assembly. Une réponse réussie contient uniquement ok et assembly_id ; une réponse d’erreur conserve error, http_code, message, reason et assembly_id lorsqu’ils sont disponibles. Il s’agit d’une réduction de la réponse, et non d’un contrôle d’accès : toute personne disposant de l’identifiant d’Assembly renvoyé peut toujours récupérer l’Assembly Status complet, y compris fields et results, sans authentification supplémentaire. Traitez les identifiants d’Assembly et les URL de statut comme des capacités secrètes. L’Assembly Status complet est toujours envoyé à notify_url si ce paramètre est configuré.
`params.redirect_url`	`string` URL vers laquelle rediriger un téléversement effectué depuis le navigateur, une fois ce téléversement terminé. L’identifiant de l’Assembly et l’URL de statut sont ajoutés en tant que paramètres de requête, tout en conservant les éventuels paramètres de requête et le fragment existants.
`params.response_headers`	`object` En-têtes de réponse personnalisés émis par une Assembly. Les surcharges CORS doivent figurer dans `cors` ; les autres clés de premier niveau sont émises sous forme d’en-têtes personnalisés. `params.response_headers`: Les champs autres que ceux répertoriés pour cet objet sont acceptés.
`params.response_headers.cors`	`object` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`params.usage_tags`	`string` Étiquettes d’utilisation enregistrées sur une Assembly.

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : steps, template_id

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Champ	Type et description
`params.steps` obligatoire	`object` Valeurs partielles de Step fusionnées dans les Steps nommés du Template enregistré. Leur structure complète, spécifique au Robot, est validée après le chargement du Template. Schéma de la propriété supplémentaire `object` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`params.template_id` obligatoire	`string` (longueur minimale : 1) L’ID du Template qui contient vos Assembly Instructions. Si vous définissez `allow_steps_override` sur `false` dans votre Template, alors `steps` et `template_id` seront mutuellement exclusifs : vous ne pourrez fournir qu’un seul de ces paramètres.

Variante 2

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Champ	Type et description
`params.steps`	`object` Contient les Assembly Instructions. Schéma de la propriété supplémentaire `object` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`params.template_id`	`string` L’ID du Template qui contient vos Assembly Instructions. Si vous définissez `allow_steps_override` sur `false` dans votre Template, alors `steps` et `template_id` seront mutuellement exclusifs : vous ne pourrez fournir qu’un seul de ces paramètres.

Paramètres de requête par méthode d’authentification

Avec des paramètres signés

Incluez votre Auth Key dans params.auth.key. Lors de la signature de la requête, incluez un horodatage futur dans params.auth.expires et envoyez la signature dans le champ distinct signature. Les définitions des champs ci-dessous utilisent des chemins à l’intérieur de params.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Paramètres signés utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

Utilise les définitions des champs ci-dessus : params.auth, params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : steps, template_id

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.steps, params.template_id

Variante 2

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.steps, params.template_id

Avec un jeton porteur

Envoyez le jeton porteur dans l’en-tête Authorization. Vous pouvez omettre params.auth et le champ distinct signature. Les autres paramètres obligatoires restent requis. Les définitions des champs ci-dessous utilisent des chemins à l’intérieur de params.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

Utilise les définitions des champs ci-dessus : params.emit_execution_progress, params.exiftool_stack, params.ffmpeg_stack, params.fields, params.imagemagick_stack, params.mediainfo_stack, params.mplayer_stack, params.nonce, params.notification_payload, params.notify_url, params.quiet, params.redirect_url, params.response_headers, params.usage_tags

Champ	Type et description
`params.auth`	`object` Métadonnées d’authentification et contraintes de téléversement pour une requête d’Assembly authentifiée par Bearer. Le jeton fournit la clé d’API, la requête peut donc l’omettre. La propriété `referer` est une expression régulière à comparer au referer HTTP de ce téléversement, par exemple `"example\.org"`. Utilisez-la pour vérifier les valeurs Referer fournies par rapport à un domaine attendu. Les téléversements sans referer seront toujours acceptés (car celui-ci est désactivé dans certains navigateurs), ce qui rend cette option utile dans seulement quelques cas d’usage. Pour en savoir plus sur les expressions régulières, consultez la documentation RegExp de Mozilla. Les expressions régulières invalides et les expressions qui dépassent la limite de temps d’évaluation sont rejetées. Cette vérification ne remplace pas la Signature Authentication : les clients peuvent omettre ou falsifier l’en-tête Referer. La propriété `max_size` limite la taille totale de téléversement attendue de l’Assembly en octets, par exemple `1048576` (1 MB), plutôt que celle de chaque fichier séparément. Cela inclut le corps de la requête multipart, ou les octets de la requête initiale de l’Assembly plus ses téléversements avec reprise. Le dépassement de la limite arrête l’Assembly entière avec une erreur, y compris les fichiers qui respectent individuellement la limite. Ne comptez pas sur cette limite pour rejeter chaque transfert trop volumineux avant qu’il ne commence. Pour les téléversements avec reprise, la taille déclarée ou reçue devient disponible via les mises à jour tus, et l’Assembly vérifie la limite lorsqu’un téléversement terminé est traité. La taille d’un téléversement différé n’est pas connue lors de sa création, et des octets peuvent déjà avoir été transférés avant que l’Assembly ne le rejette. Si vous souhaitez simplement ignorer les fichiers qui dépassent une certaine taille tout en traitant tous les autres, utilisez 🤖/file/filter (English). La propriété `max_number_of_files` permet de définir le nombre maximal de fichiers qu’un téléversement peut contenir, par exemple `100`. Indiquez-la pour empêcher les utilisateurs de téléverser un nombre excessif de fichiers, que ce soit par des téléversements de fichiers ou par des Robots d’importation. Ces propriétés peuvent être définies dans la requête d’Assembly ou dans le Template. `params.auth`: Seuls les champs répertoriés pour cet objet sont acceptés.
`params.auth.expires`	`string` Horodatage d’expiration au format ISO 8601 situé dans le futur. Obligatoire lorsqu’une requête est signée ou nécessite Signature Authentication ; les requêtes authentifiées par jeton porteur peuvent l’omettre.
`params.auth.key`	`string` Clé API Transloadit utilisée pour authentifier les requêtes
`params.auth.max_number_of_files`	`integer` (minimum : 1) Nombre maximal de fichiers d’entrée autorisés par Assembly. Si le nombre de fichiers téléversés ou importés dépasse cette limite, l’Assembly sera arrêtée avec une erreur. Cette limite est utile pour prévenir les abus lorsque les informations d’authentification de Signature Authentication sont exposées.
`params.auth.max_size`	`number` Taille totale maximale attendue du téléversement pour l’Assembly, en octets, y compris la surcharge liée au corps de la requête. Il ne s’agit pas d’une limite par fichier et cela ne garantit pas le rejet avant le début d’un transfert pouvant être repris.
`params.auth.referer`	`string` Expression régulière appliquée à un en-tête HTTP Referer fourni. Les expressions non valides et celles qui dépassent la limite de temps d’évaluation sont rejetées. Les requêtes sans en-tête Referer passent cette vérification ; utilisez Signature Authentication pour authentifier les requêtes.

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : steps, template_id

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.steps, params.template_id

Variante 2

Paramètres utilisés pour créer une Assembly à partir de Steps directs ou d’un Template.

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.steps, params.template_id

Vous pouvez également fournir ici d’autres champs POST (qui ne sont pas nommés params, signature ou num_expected_upload_files ou tus_num_expected_upload_files). Ils peuvent être utilisés comme variables pour rendre vos Assembly Instructions dynamiques (English).

Réponse

Voici un exemple de corps de réponse :

{
  "account_id": "6c8b8d10d68b11e3a799b579dfce333a",
  "assembly_id": "0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_ssl_url": "https://api2-morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "assembly_url": "http://api2.morven.transloadit.com/assemblies/0fce5b1063e611e88d8eb130f7921d8a",
  "bytes_expected": 1687,
  "bytes_received": 1687,
  "bytes_usage": 0,
  "companion_url": "https://api2-morven.transloadit.com/companion/",
  "execution_duration": 0.001,
  "execution_start": "2018/05/30 08:47:19 GMT",
  "fields": {},
  "instance": "morven.transloadit.com",
  "jobs_queue_duration": 0,
  "message": "The Assembly is currently being executed.",
  "ok": "ASSEMBLY_EXECUTING",
  "parent_id": null,
  "queue_duration": 0.04,
  "results": {},
  "start_date": "2018/05/30 08:47:19 GMT",
  "template": null,
  "template_id": null,
  "tus_url": "https://api2-morven.transloadit.com/resumable/files/",
  "update_stream_url": "https://api2-morven.transloadit.com/ws20243?assembly=0fce5b1063e611e88d8eb130f7921d8a",
  "upload_duration": 0.049,
  "uploads": [],
  "uppyserver_url": "https://api2-morven.transloadit.com/companion/",
  "warnings": [],
  "websocket_url": "https://api2-morven.transloadit.com/ws20243"
}

Succès 2xx

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Champ Type et description

null | string

null | string

null | string

null | string

string

string

L’ID unique de cette Assembly. Vous pouvez l’enregistrer dans une base de données lorsqu’une Assembly est créée, et l’utiliser pour faire correspondre les Notifications entrantes.

assembly_ssl_url

null | string

L’URL unique utilisée pour consulter l’état actuel de cette Assembly, mais prête à être utilisée via SSL/HTTPS. Toutes les requêtes API envoyées à assembly_url peuvent également être envoyées à assembly_ssl_url.

assembly_url

null | string

L’URL unique utilisée pour consulter l’état actuel de cette Assembly.

build_id

string

Identifiant de build facultatif pour le dépannage par l’assistance. Traitez-le comme une valeur opaque ; il peut changer d’une Assembly à l’autre.

bytes_expected

number

Le nombre d’octets que cette Assembly s’attend à recevoir par téléversement.

bytes_received

number

Le nombre d’octets téléversés vers cette Assembly jusqu’à présent. Cette valeur est principalement utilisée par les clients pour afficher la progression du téléversement.

bytes_usage

number | null

Le nombre total d’octets traités par cette Assembly qui sont pris en compte dans la facturation de votre utilisation. La somme des valeurs bytes_usage de toutes vos Assemblies correspond à votre utilisation mensuelle totale.

client_agent

null | string

L’agent utilisateur du client de téléversement n’est pas exposé ; ce champ obsolète vaut toujours null.

client_ip

null | string

L’adresse IP de l’auteur du téléversement n’est pas exposée ; ce champ obsolète est toujours null.

client_referer

null | string

L’URL de provenance de l’outil de téléversement n’est pas exposée ; ce champ déprécié vaut toujours null.

companion_url

null | string

L’URL du serveur Companion avec lequel cette Assembly peut communiquer.

executing_jobs

Array<string>

Schéma d’un élément de tableau

string

execution_duration

number | null

Le temps mis par Transloadit pour exécuter cette Assembly, en secondes.

execution_start

null | string

expected_tus_uploads

number

fields

object

Un dictionnaire clé/valeur de champs de formulaire supplémentaires pour les intégrations qui ne peuvent pas utiliser l’encapsulation <form>, comme Uppy.

Schéma de la propriété supplémentaire

n’importe quelle valeur

finished_tus_uploads

number

has_dupe_jobs

boolean

ignored_error_count

number

ignored_errors

Array<object>

Schéma d’un élément de tableau

object

ignored_errors[]: La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`ignored_errors[].error`	`n’importe quelle valeur`
`ignored_errors[].message`	`string`
`ignored_errors[].phase`	`string`
`ignored_errors[].step`	`null \| string`

info

object

info: La réponse peut contenir des champs supplémentaires.

info.retryIn

number

instance

null | string

is_infinite

boolean

jobs_queue_duration

number

last_job_completed

null | string

merged_params

null | string

message

string

Un message lisible par un humain expliquant l’état de cette Assembly. Ce message n’est pas toujours présent.

notify_duration

number | null

Temps écoulé pour la livraison, en secondes, y compris les nouvelles tentatives automatiques et les délais qui les séparent.

notify_error

null | string

notify_response_code

number | null

notify_response_data

null | string

null | string

null | string

null | string

number

params

null | string

parent_assembly_status

n’importe quelle valeur | null

N’importe lequel des schémas suivants peut s’appliquer :

n’importe quelle valeur

n’importe quelle valeur

null

parent_id

null | string

previousStep

string

Nom du Step précédent associé à l’erreur, lorsqu’il est disponible.

queue_duration

number

region

string

results

object

Les fichiers de résultat que Transloadit a produits jusqu’à présent. Chaque clé est le nom du Step qui a produit un fichier. Les Robots de stockage ne produisent pas de fichiers, donc leurs noms de Step sont omis. Lorsqu’une error se produit, cet objet peut contenir des résultats partiels.

Schéma de la propriété supplémentaire

Array<object>

Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.

running_jobs

Array<string>

Schéma d’un élément de tableau

string

start_date

string

La date et l’heure auxquelles le téléversement a commencé pour cette Assembly.

started_jobs

Array<string>

Schéma d’un élément de tableau

string

started_tus_uploads

number

step

string

Nom du Step associé à l’erreur, lorsqu’il est disponible.

null | string

null | string

null | string

null | string

Array<object>

Schéma d’un élément de tableau

object

tus_uploads[]: La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`tus_uploads[].fieldname` obligatoire	`string`
`tus_uploads[].filename` obligatoire	`string`
`tus_uploads[].finished` obligatoire	`boolean`
`tus_uploads[].offset` obligatoire	`number`
`tus_uploads[].size` obligatoire	`number`
`tus_uploads[].upload_url` obligatoire	`string`
`tus_uploads[].user_meta`	`object` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.

tus_url

string

L’URL du serveur tus utilisé par cette Assembly pour les téléversements avec reprise.

update_stream_url

null | string

L’URL d’un flux d’événements envoyés par le serveur, à partir duquel vous pouvez obtenir des mises à jour en temps réel de l’état de cette Assembly.

upload_duration

number

Le temps mis par l’outil de téléversement pour téléverser les fichiers, en secondes.

upload_meta_data_extracted

boolean

uploads

Array<object>

Un tableau de fichiers téléversés pour cette Assembly. Pour plus d’informations, consultez la documentation sur les métadonnées.

Schéma d’un élément de tableau

object

Champ	Type et description
`uploads[].as`	`string \| Array<string> \| null` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`uploads[].asset_id`	`string` Identité stable d’un fichier stocké par `/transloadit/store`. Conservez-la avec son Workspace et son `version_id` ; l’`id` ordinaire du fichier n’est pas un identifiant de ressource de stockage.
`uploads[].asset_version`	`number` Numéro de révision de la ressource stockée. Utilisez `version_id`, et non ce nombre, pour sélectionner les octets exacts conservés.
`uploads[].cost`	`number \| null`
`uploads[].exec_time`	`number`
`uploads[].from_batch_import`	`boolean`
`uploads[].has_alpha`	`boolean` Indique si cette version stockée de l’image possède un canal alpha, lorsque cette information est connue.
`uploads[].import_url`	`string`
`uploads[].is_temp_url`	`boolean`
`uploads[].is_tus_file`	`boolean`
`uploads[].md5hash`	`null \| string`
`uploads[].original_basename`	`null \| string`
`uploads[].original_id` obligatoire	`string \| Array<null \| string>` L’ID unique du fichier téléversé d’origine à partir duquel ce fichier a été généré. Cet ID est utile pour déterminer quel fichier d’un téléversement de plusieurs fichiers a été utilisé pour générer un fichier donné, après plusieurs Steps de traitement. Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`uploads[].original_md5hash`	`null \| string`
`uploads[].original_name`	`null \| string`
`uploads[].original_path`	`string`
`uploads[].queue`	`null \| string`
`uploads[].queue_time`	`number`
`uploads[].sha256`	`string` Somme de contrôle SHA-256 en minuscules des octets stockés, lorsqu’elle est disponible. Motif de validation (expression régulière) `^[a-f0-9]{64}$`
`uploads[].ssl_url`	`null \| string`
`uploads[].thumbhash`	`string` ThumbHash encodé en Base64, conservé avec cette version stockée de l’image, lorsqu’il est disponible. Protégez ces données d’image avec les mêmes contrôles d’accès que l’original. Motif de validation (expression régulière) `^(?:[A-Za-z0-9+/]{4}){1,15}(?:[A-Za-z0-9+/]{4}\|[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)$`
`uploads[].tus_upload_url`	`null \| string`
`uploads[].user_meta`	`object` Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`uploads[].version_id`	`string` Identifiant de version immuable renvoyé après la finalisation du résultat par le stockage. Importez avec `asset_id` et ce `version_id` pour conserver les mêmes octets après un déplacement ou un écrasement, sous réserve des conditions de rétention et d’accès. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$`
`uploads[].workspace`	`string` (longueur minimale : 1) Slug du Workspace auquel appartient ce résultat stocké. Authentifiez-vous pour ce Workspace lorsque vous importez ou gérez ce résultat.

N’importe lequel des schémas suivants peut s’appliquer :

propriétés requises : basename, ext, field, id, meta, mime, name, size, type, url: object

object

uploads[]: La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`uploads[].basename` obligatoire	`null \| string` Le nom du fichier sans son extension.
`uploads[].ext` obligatoire	`string` L’extension du fichier.
`uploads[].field` obligatoire	`null \| string` Le nom du champ de formulaire utilisé pour envoyer ce fichier.
`uploads[].id` obligatoire	`string` Un identifiant aléatoire et unique utilisé en interne par Transloadit pour suivre le fichier.
`uploads[].meta` obligatoire	`object` Un objet contenant des métadonnées supplémentaires extraites du fichier, comme indiqué ci-dessous. Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`uploads[].mime` obligatoire	`null \| string` Le type MIME déterminé pour ce fichier.
`uploads[].name` obligatoire	`null \| string` Le nom du fichier. Transloadit modifiera l’extension utilisée pour ce champ si le fichier est converti dans un autre format lors du traitement.
`uploads[].size` obligatoire	`number` La taille du fichier, en octets.
`uploads[].type` obligatoire	`null \| string` Une catégorie abstraite décrivant le fichier. Les valeurs connues sont `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` ou `null` lorsqu’aucune catégorie n’a été détectée. Les consommateurs devraient accepter d’autres chaînes afin de maintenir la compatibilité avec les futures catégories.
`uploads[].url` obligatoire	`null \| string` Une URL à partir de laquelle le fichier peut être téléchargé, ou `null` lorsqu’aucune URL de diffusion n’est disponible. Les URL temporaires sur nos serveurs expirent au bout de quelques heures ; exportez les fichiers vers un espace de stockage pour les utiliser ultérieurement. Les résultats de `/transloadit/store` pour le stockage privé renvoient `null` à la fois pour `url` et pour `ssl_url`. Conservez le Workspace, l’`asset_id` et le `version_id` renvoyés pour disposer d’une référence durable, sous réserve des conditions d’accès et de conservation. `/transloadit/import` accepte un `asset_id` avec un `version_id` facultatif, ou un `path` modifiable. Ni une URL temporaire ni l’`id` du fichier de traitement ne constituent une référence durable au stockage.

Variante 2: object

object

uploads[]: La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`uploads[].basename`	`null \| string` Le nom du fichier sans son extension.
`uploads[].ext`	`string` L’extension du fichier.
`uploads[].field`	`null \| string` Le nom du champ de formulaire utilisé pour envoyer ce fichier.
`uploads[].id`	`jamais` Cette valeur est interdite.
`uploads[].meta`	`object` Un objet contenant des métadonnées supplémentaires extraites du fichier, comme indiqué ci-dessous. Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`uploads[].mime`	`null \| string` Le type MIME déterminé pour ce fichier.
`uploads[].name`	`null \| string` Le nom du fichier. Transloadit modifiera l’extension utilisée pour ce champ si le fichier est converti dans un autre format lors du traitement.
`uploads[].size`	`number` La taille du fichier, en octets.
`uploads[].type`	`null \| string` Une catégorie abstraite décrivant le fichier. Les valeurs connues sont `"audio"`, `"document"`, `"image"`, `"office"`, `"pdf"`, `"swf"`, `"video"`, `"xls"` ou `null` lorsqu’aucune catégorie n’a été détectée. Les consommateurs devraient accepter d’autres chaînes afin de maintenir la compatibilité avec les futures catégories.
`uploads[].url`	`null \| string` Une URL à partir de laquelle le fichier peut être téléchargé, ou `null` lorsqu’aucune URL de diffusion n’est disponible. Les URL temporaires sur nos serveurs expirent au bout de quelques heures ; exportez les fichiers vers un espace de stockage pour les utiliser ultérieurement. Les résultats de `/transloadit/store` pour le stockage privé renvoient `null` à la fois pour `url` et pour `ssl_url`. Conservez le Workspace, l’`asset_id` et le `version_id` renvoyés pour disposer d’une référence durable, sous réserve des conditions d’accès et de conservation. `/transloadit/import` accepte un `asset_id` avec un `version_id` facultatif, ou un `path` modifiable. Ni une URL temporaire ni l’`id` du fichier de traitement ne constituent une référence durable au stockage.

null | string

string

string

Array<object>

Schéma d’un élément de tableau

object

warnings[]: La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`warnings[].action`	`object` (propriétés requises : message, text, type) Des détails supplémentaires sur le schéma sont disponibles dans le schéma JSON complet.
`warnings[].level` obligatoire	`"notice" \| "warning"`
`warnings[].msg` obligatoire	`string`

websocket_url

null | string

L’URL d’un serveur Websocket (utilisant Socket.IO) depuis lequel vous pouvez obtenir des mises à jour en temps réel de l’état de cette Assembly.

N’importe lequel des schémas suivants peut s’appliquer :

ok: "ASSEMBLY_EXECUTING" | "ASSEMBLY_REPLAYING" | "ASSEMBLY_UPLOADING"

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error`	`jamais` Indique un statut d’erreur. Cette clé n’est présente que si l’Assembly a échoué. Cette valeur est interdite.
`ok` obligatoire	`"ASSEMBLY_EXECUTING" \| "ASSEMBLY_REPLAYING" \| "ASSEMBLY_UPLOADING"` Indique un statut de cycle de vie sans erreur, y compris les états de téléversement, d’exécution, d’abandon et d’annulation. La réussite du traitement est indiquée par `ASSEMBLY_COMPLETED`. Si l’Assembly a rencontré une erreur, la clé `error` ci-dessous est utilisée à la place de cette clé.

ok: string

La réponse peut contenir des champs supplémentaires.

Champ Type et description

error

jamais

Indique un statut d’erreur. Cette clé n’est présente que si l’Assembly a échoué.

Cette valeur est interdite.

ok

obligatoire

string

Indique un statut de cycle de vie sans erreur, y compris les états de téléversement, d’exécution, d’abandon et d’annulation. La réussite du traitement est indiquée par ASSEMBLY_COMPLETED. Si l’Assembly a rencontré une erreur, la clé error ci-dessous est utilisée à la place de cette clé.

Valeurs autorisées (6)

"ASSEMBLY_CANCELED"
"ASSEMBLY_COMPLETED"
"ASSEMBLY_EXECUTING"
"ASSEMBLY_REPLAYING"
"ASSEMBLY_UPLOADING"
"REQUEST_ABORTED"

propriétés requises : error

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`cmd`	`string \| Array<string \| number>` Détails facultatifs sur la commande de traitement pour le dépannage. Les détails de diagnostic peuvent varier ; utilisez le code `error` pour gérer les erreurs par programmation. N’importe lequel des schémas suivants peut s’appliquer : `string` Array<string \| number> `Array<string \| number>` Schéma d’un élément de tableau `string \| number`
`error` obligatoire	`string` Indique un statut d’erreur. Cette clé n’est présente que si l’Assembly a échoué. Valeurs autorisées (362) `"ADMIN_PERMISSIONS_REQUIRED"` `"AI_CHAT_VALIDATION"` `"ASSEMBLY_ACCOUNT_MISMATCH"` `"ASSEMBLY_CANNOT_BE_REPLAYED"` `"ASSEMBLY_COULD_NOT_BE_CREATED"` `"ASSEMBLY_CRASHED"` `"ASSEMBLY_DISALLOWED_ROBOTS_USED"` `"ASSEMBLY_EMPTY_STEPS"` `"ASSEMBLY_EXECUTION_PROGRESS_NOT_ENABLED"` `"ASSEMBLY_EXPIRED"` `"ASSEMBLY_FILE_NOT_RESERVED"` `"ASSEMBLY_INFINITE"` `"ASSEMBLY_INVALID_NOTIFY_URL"` `"ASSEMBLY_INVALID_NUM_EXPECTED_UPLOAD_FILES_PARAM"` `"ASSEMBLY_INVALID_STEPS"` `"ASSEMBLY_JOB_ENQUEUE_ERROR"` `"ASSEMBLY_LIST_ERROR"` `"ASSEMBLY_MEMORY_LIMIT_EXCEEDED"` `"ASSEMBLY_NOTIFICATIONS_LIST_ERROR"` `"ASSEMBLY_NOTIFICATION_LIST_ERROR"` `"ASSEMBLY_NOTIFICATION_NOT_PERSISTED"` `"ASSEMBLY_NOTIFICATION_NOT_REPLAYED"` `"ASSEMBLY_NOT_CAPABLE"` `"ASSEMBLY_NOT_FINISHED"` `"ASSEMBLY_NOT_FOUND"` `"ASSEMBLY_NOT_REPLAYED"` `"ASSEMBLY_NO_CHARGEABLE_STEP"` `"ASSEMBLY_NO_NOTIFY_URL"` `"ASSEMBLY_NO_STEPS"` `"ASSEMBLY_PLAN_FILE_SIZE_LIMIT_EXCEEDED"` `"ASSEMBLY_ROBOT_MISSING"` `"ASSEMBLY_SATURATED"` `"ASSEMBLY_STATS_ERROR"` `"ASSEMBLY_STATS_INVALID_TIME"` `"ASSEMBLY_STATS_MISSING_REGION"` `"ASSEMBLY_STATUS_FETCHING_RATE_LIMIT_REACHED"` `"ASSEMBLY_STATUS_NOT_FOUND"` `"ASSEMBLY_STATUS_PARSE_ERROR"` `"ASSEMBLY_STEP_INVALID"` `"ASSEMBLY_STEP_INVALID_ROBOT"` `"ASSEMBLY_STEP_INVALID_USE"` `"ASSEMBLY_STEP_NO_ROBOT"` `"ASSEMBLY_STEP_UNKNOWN_ROBOT"` `"ASSEMBLY_STEP_UNKNOWN_USE"` `"ASSEMBLY_URL_TRANSFORM_MISSING"` `"AUDIO_ARTWORK_VALIDATION"` `"AUDIO_CONCAT_INVALID_INPUT"` `"AUDIO_CONCAT_VALIDATION"` `"AUDIO_ENCODE_VALIDATION"` `"AUDIO_LOOP_VALIDATION"` `"AUDIO_MERGE_VALIDATION"` `"AUDIO_SPLIT_NO_OUTPUT"` `"AUDIO_SPLIT_VALIDATION"` `"AUDIO_WAVEFORM_VALIDATION"` `"AUTH_EXPIRED"` `"AUTH_KEYS_NOT_FOUND"` `"AUTH_KEY_SCOPES_NOT_FOUND"` `"AUTH_SECRET_NOT_RETRIEVED"` `"AZURE_IMPORT_ACCESS_DENIED"` `"AZURE_IMPORT_FAILURE"` `"AZURE_IMPORT_NOT_FOUND"` `"AZURE_IMPORT_VALIDATION"` `"AZURE_STORE_ACCESS_DENIED"` `"AZURE_STORE_NOT_FOUND"` `"AZURE_STORE_VALIDATION"` `"BACKBLAZE_IMPORT_ACCESS_DENIED"` `"BACKBLAZE_IMPORT_FAILURE"` `"BACKBLAZE_IMPORT_NOT_FOUND"` `"BACKBLAZE_IMPORT_VALIDATION"` `"BACKBLAZE_STORE_ACCESS_DENIED"` `"BACKBLAZE_STORE_FAILURE"` `"BACKBLAZE_STORE_VALIDATION"` `"BAD_PRICING"` `"BEARER_TOKEN_AUTH_KEY_MISMATCH"` `"BEARER_TOKEN_EXPIRED"` `"BEARER_TOKEN_INVALID"` `"BILL_LIMIT_EXCEEDED"` `"BOX_IMPORT_ACCESS_DENIED"` `"BOX_IMPORT_FAILURE"` `"BOX_IMPORT_NOT_FOUND"` `"BOX_IMPORT_VALIDATION"` `"BOX_STORE_COULD_NOT_PARSE_URL"` `"BOX_STORE_VALIDATION"` `"CANNOT_ACCEPT_NEW_ASSEMBLIES"` `"CDN_REQUIRED"` `"CLOUDFILES_IMPORT_ACCESS_DENIED"` `"CLOUDFILES_IMPORT_FAILURE"` `"CLOUDFILES_IMPORT_NOT_FOUND"` `"CLOUDFILES_IMPORT_VALIDATION"` `"CLOUDFILES_STORE_ACCESS_DENIED"` `"CLOUDFILES_STORE_ERROR"` `"CLOUDFILES_STORE_VALIDATION"` `"CLOUDFLARE_IMPORT_ACCESS_DENIED"` `"CLOUDFLARE_IMPORT_FAILURE"` `"CLOUDFLARE_IMPORT_NOT_FOUND"` `"CLOUDFLARE_IMPORT_VALIDATION"` `"CLOUDFLARE_STORE_ACCESS_DENIED"` `"CLOUDFLARE_STORE_NOT_FOUND"` `"CLOUDFLARE_STORE_URL_VERIFICATION_FAILURE"` `"CLOUDFLARE_STORE_VALIDATION"` `"CLOUDFLARE_STORE_WRONG_REGION"` `"CLOUD_AI_IMAGE_VALIDATION"` `"DIGITALOCEAN_IMPORT_ACCESS_DENIED"` `"DIGITALOCEAN_IMPORT_FAILURE"` `"DIGITALOCEAN_IMPORT_NOT_FOUND"` `"DIGITALOCEAN_IMPORT_VALIDATION"` `"DIGITALOCEAN_STORE_ACCESS_DENIED"` `"DIGITALOCEAN_STORE_NOT_FOUND"` `"DIGITALOCEAN_STORE_VALIDATION"` `"DIGITALOCEAN_STORE_WRONG_REGION"` `"DOCUMENT_AUTOROTATE_VALIDATION"` `"DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION"` `"DOCUMENT_CONVERT_VALIDATION"` `"DOCUMENT_EXTRACT_VALIDATION"` `"DOCUMENT_MERGE_UNSUPPORTED_CONVERSION"` `"DOCUMENT_MERGE_VALIDATION"` `"DOCUMENT_OCR_VALIDATION"` `"DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT"` `"DOCUMENT_OPTIMIZE_VALIDATION"` `"DOCUMENT_SPLIT_VALIDATION"` `"DOCUMENT_THUMBS_INVALID_INPUT"` `"DOCUMENT_THUMBS_VALIDATION"` `"DO_NOT_REUSE_ASSEMBLY_IDS"` `"DROPBOX_IMPORT_ACCESS_DENIED"` `"DROPBOX_IMPORT_FAILURE"` `"DROPBOX_IMPORT_NOT_FOUND"` `"DROPBOX_IMPORT_VALIDATION"` `"DROPBOX_STORE_COULD_NOT_PARSE_URL"` `"DROPBOX_STORE_VALIDATION"` `"FILE_COMPRESS_INVALID_INPUT"` `"FILE_COMPRESS_VALIDATION"` `"FILE_DECOMPRESS_INVALID_INPUT"` `"FILE_DECOMPRESS_PASSWORD_INCORRECT"` `"FILE_DECOMPRESS_PASSWORD_REQUIRED"` `"FILE_DECOMPRESS_VALIDATION"` `"FILE_DOWNLOAD_ERROR"` `"FILE_FILTER_DECLINED_FILE"` `"FILE_FILTER_INVALID_OPERATOR"` `"FILE_FILTER_VALIDATION"` `"FILE_HASH_VALIDATION"` `"FILE_META_DATA_ERROR"` `"FILE_PREVIEW_VALIDATION"` `"FILE_READ_VALIDATION_ERROR"` `"FILE_SERVE_NO_RESULT"` `"FILE_SERVE_VALIDATION"` `"FILE_VERIFY_INVALID_FILE"` `"FILE_VERIFY_VALIDATION"` `"FILE_VIRUSSCAN_DECLINED_FILE"` `"FILE_VIRUSSCAN_INVALID_INPUT"` `"FILE_VIRUSSCAN_VALIDATION"` `"FTP_IMPORT_ACCESS_DENIED"` `"FTP_IMPORT_FAILURE"` `"FTP_IMPORT_NOT_FOUND"` `"FTP_IMPORT_VALIDATION"` `"FTP_STORE_VALIDATION"` `"GET_ACCOUNT_DB_ERROR"` `"GET_ACCOUNT_UNKNOWN_AUTH_KEY"` `"GOOGLE_IMPORT_ACCESS_DENIED"` `"GOOGLE_IMPORT_FAILURE"` `"GOOGLE_IMPORT_NOT_FOUND"` `"GOOGLE_IMPORT_VALIDATION"` `"GOOGLE_STORE_INVALID_INPUT"` `"GOOGLE_STORE_VALIDATION"` `"HTML_CONVERT_VALIDATION"` `"HTTP_IMPORT_ACCESS_DENIED"` `"HTTP_IMPORT_FAILURE"` `"HTTP_IMPORT_NOT_FOUND"` `"HTTP_IMPORT_VALIDATION"` `"HTTP_REQUEST_FAILURE"` `"HTTP_REQUEST_VALIDATION"` `"IMAGE_BGREMOVE_VALIDATION"` `"IMAGE_COPYRIGHT_DETECT_DECLINED_FILE"` `"IMAGE_COPYRIGHT_DETECT_VALIDATION"` `"IMAGE_DESCRIBE_VALIDATION"` `"IMAGE_ENHANCE_NO_INPUT_FILE"` `"IMAGE_ENHANCE_VALIDATION"` `"IMAGE_FACEDETECT_VALIDATION"` `"IMAGE_GENERATE_VALIDATION"` `"IMAGE_MERGE_FAILURE"` `"IMAGE_MERGE_VALIDATION"` `"IMAGE_OCR_VALIDATION"` `"IMAGE_OPTIMIZE_VALIDATION"` `"IMAGE_RESIZE_ERROR"` `"IMAGE_RESIZE_INVALID_BLUR_REGION"` `"IMAGE_RESIZE_INVALID_TEXT_OBJECT_VALUE"` `"IMAGE_RESIZE_INVALID_TEXT_VALUE"` `"IMAGE_RESIZE_INVALID_WATERMARK_OFFSET"` `"IMAGE_RESIZE_INVALID_WATERMARK_POSITION"` `"IMAGE_RESIZE_NO_CLUT_FILE"` `"IMAGE_RESIZE_NO_INPUT_FILE"` `"IMAGE_RESIZE_VALIDATION"` `"IMAGE_UPSCALE_VALIDATION"` `"IMPORT_FILE_ERROR"` `"INCOMPLETE_PRICING"` `"INSUFFICIENT_AUTH_SCOPE"` `"INTERNAL_COMMAND_ERROR"` `"INTERNAL_COMMAND_TIMEOUT"` `"INVALID_ASSEMBLY_STATUS"` `"INVALID_AUTH_EXPIRES_PARAMETER"` `"INVALID_AUTH_KEY_PARAMETER"` `"INVALID_AUTH_MAX_NUMBER_OF_FILES_PARAMETER"` `"INVALID_AUTH_MAX_SIZE_PARAMETER"` `"INVALID_AUTH_REFERER_PARAMETER"` `"INVALID_FILE_META_DATA"` `"INVALID_FORM_DATA"` `"INVALID_INPUT_ERROR"` `"INVALID_PARAMS_FIELD"` `"INVALID_SIGNATURE"` `"INVALID_STEP_NAME"` `"INVALID_TEMPLATE_FIELD"` `"INVALID_UPLOAD_HANDLE_STEP_NAME"` `"INVALID_URL_ENCODING"` `"MAX_NUMBER_OF_FILES_EXCEEDED"` `"MAX_SIZE_EXCEEDED"` `"MEGA_IMPORT_ACCESS_DENIED"` `"MEGA_IMPORT_FAILURE"` `"MEGA_IMPORT_NOT_FOUND"` `"MEGA_IMPORT_VALIDATION"` `"MEGA_STORE_ACCESS_DENIED"` `"MEGA_STORE_NOT_FOUND"` `"MEGA_STORE_VALIDATION"` `"MEGA_STORE_WRONG_REGION"` `"META_WRITE_VALIDATION"` `"MINIO_IMPORT_ACCESS_DENIED"` `"MINIO_IMPORT_FAILURE"` `"MINIO_IMPORT_NOT_FOUND"` `"MINIO_IMPORT_VALIDATION"` `"MINIO_STORE_ACCESS_DENIED"` `"MINIO_STORE_NOT_FOUND"` `"MINIO_STORE_VALIDATION"` `"MINIO_STORE_WRONG_REGION"` `"NO_AUTH_EXPIRES_PARAMETER"` `"NO_AUTH_KEY_PARAMETER"` `"NO_AUTH_PARAMETER"` `"NO_COUNTRY"` `"NO_OBJECT_AUTH_PARAMETER"` `"NO_OBJECT_PARAMS_FIELD"` `"NO_PARAMS_FIELD"` `"NO_PRICING"` `"NO_RESULT_STEP_FOUND"` `"NO_RPC_RESULT_FROM_IMAGE_RESIZER"` `"NO_SIGNATURE_FIELD"` `"NO_TEMPLATE_ID"` `"PLAN_LIMIT_EXCEEDED"` `"POSSIBLY_MALICIOUS_FILE_FOUND"` `"PRIORITY_JOB_SLOTS_NOT_FOUND"` `"PRIORITY_JOB_SLOT_STATS_ERROR"` `"PRIORITY_JOB_SLOT_STATS_INVALID_AGGREGATION"` `"PRIORITY_JOB_SLOT_STATS_INVALID_TIME"` `"PRIORITY_JOB_SLOT_STATS_MISSING_REGION"` `"RATE_LIMIT_REACHED"` `"REFERER_MISMATCH"` `"REQUEST_PREMATURE_CLOSED"` `"ROBOT_VALIDATION_BASE_ERROR"` `"S3_ACCESS_DENIED"` `"S3_IMPORT_ACCESS_DENIED"` `"S3_IMPORT_FAILURE"` `"S3_IMPORT_NOT_FOUND"` `"S3_IMPORT_VALIDATION"` `"S3_NOT_FOUND"` `"S3_STORE_ACCESS_DENIED"` `"S3_STORE_FAILURE"` `"S3_STORE_NOT_FOUND"` `"S3_STORE_URL_VERIFICATION_FAILURE"` `"S3_STORE_VALIDATION"` `"S3_STORE_WRONG_REGION"` `"S3_WRONG_REGION"` `"SCRIPT_RUN_VALIDATION"` `"SERVER_403"` `"SERVER_404"` `"SERVER_500"` `"SFTP_IMPORT_ACCESS_DENIED"` `"SFTP_IMPORT_FAILURE"` `"SFTP_IMPORT_NOT_FOUND"` `"SFTP_IMPORT_VALIDATION"` `"SFTP_STORE_VALIDATION"` `"SIGNATURE_REUSE_DETECTED"` `"SPEECH_TRANSCRIBE_VALIDATION"` `"STORAGE_GRANT_NOT_CREATED"` `"SUPABASE_IMPORT_ACCESS_DENIED"` `"SUPABASE_IMPORT_FAILURE"` `"SUPABASE_IMPORT_NOT_FOUND"` `"SUPABASE_IMPORT_VALIDATION"` `"SUPABASE_STORE_ACCESS_DENIED"` `"SUPABASE_STORE_NOT_FOUND"` `"SUPABASE_STORE_VALIDATION"` `"SUPABASE_STORE_WRONG_REGION"` `"SWIFT_IMPORT_ACCESS_DENIED"` `"SWIFT_IMPORT_FAILURE"` `"SWIFT_IMPORT_NOT_FOUND"` `"SWIFT_IMPORT_VALIDATION"` `"SWIFT_STORE_ACCESS_DENIED"` `"SWIFT_STORE_NOT_FOUND"` `"SWIFT_STORE_VALIDATION"` `"SWIFT_STORE_WRONG_REGION"` `"TEMPLATE_CREDENTIALS_INJECTION_ERROR"` `"TEMPLATE_DB_ERROR"` `"TEMPLATE_DENIES_STEPS_OVERRIDE"` `"TEMPLATE_INVALID_JSON"` `"TEMPLATE_NOT_FOUND"` `"TEXT_SPEAK_VALIDATION"` `"TEXT_TRANSLATE_VALIDATION"` `"TIGRIS_IMPORT_ACCESS_DENIED"` `"TIGRIS_IMPORT_FAILURE"` `"TIGRIS_IMPORT_NOT_FOUND"` `"TIGRIS_IMPORT_VALIDATION"` `"TIGRIS_STORE_ACCESS_DENIED"` `"TIGRIS_STORE_NOT_FOUND"` `"TIGRIS_STORE_VALIDATION"` `"TIGRIS_STORE_WRONG_REGION"` `"TMP_FILE_DOWNLOAD_ERROR"` `"TOKEN_INVALID_CREDENTIALS"` `"TRANSIENT_STORAGE_SERVICE_ERROR"` `"TRANSLOADIT_IMPORT_ACCESS_DENIED"` `"TRANSLOADIT_IMPORT_FAILURE"` `"TRANSLOADIT_IMPORT_NOT_FOUND"` `"TRANSLOADIT_IMPORT_VALIDATION"` `"TRANSLOADIT_STORE_CONFLICT"` `"TRANSLOADIT_STORE_FAILURE"` `"TRANSLOADIT_STORE_UNAVAILABLE"` `"TRANSLOADIT_STORE_VALIDATION"` `"TUS_STORE_VALIDATION"` `"USER_COMMAND_ERROR"` `"VERIFIED_EMAIL_REQUIRED"` `"VIDEO_ADAPTIVE_VALIDATION"` `"VIDEO_ARTWORK_VALIDATION"` `"VIDEO_CONCAT_INVALID_INPUT"` `"VIDEO_CONCAT_NO_OUTPUT"` `"VIDEO_CONCAT_VALIDATION"` `"VIDEO_ENCODE_INVALID_VIDEO_CODEC"` `"VIDEO_ENCODE_INVALID_WATERMARK_POSITION"` `"VIDEO_ENCODE_VALIDATION"` `"VIDEO_GENERATE_VALIDATION"` `"VIDEO_MERGE_NO_IMAGE_FOUND"` `"VIDEO_MERGE_VALIDATION"` `"VIDEO_ONDEMAND_NOT_FOUND"` `"VIDEO_ONDEMAND_VALIDATION"` `"VIDEO_SPLIT_NO_OUTPUT"` `"VIDEO_SPLIT_VALIDATION"` `"VIDEO_SUBTITLE_VALIDATION"` `"VIDEO_THUMBS_INVALID_COUNT_VALUE"` `"VIDEO_THUMBS_INVALID_FORMAT"` `"VIDEO_THUMBS_INVALID_INPUT"` `"VIDEO_THUMBS_VALIDATION"` `"VIMEO_IMPORT_ACCESS_DENIED"` `"VIMEO_IMPORT_FAILURE"` `"VIMEO_IMPORT_NOT_FOUND"` `"VIMEO_IMPORT_VALIDATION"` `"VIMEO_STORE_ACCESS_DENIED"` `"VIMEO_STORE_PROBLEM_SENDING_FILE"` `"VIMEO_STORE_VALIDATION"` `"WASABI_IMPORT_ACCESS_DENIED"` `"WASABI_IMPORT_FAILURE"` `"WASABI_IMPORT_NOT_FOUND"` `"WASABI_IMPORT_VALIDATION"` `"WASABI_STORE_ACCESS_DENIED"` `"WASABI_STORE_NOT_FOUND"` `"WASABI_STORE_VALIDATION"` `"WASABI_STORE_WRONG_REGION"` `"WORKER_JOB_ERROR"` `"YOUTUBE_STORE_PROBLEM_SENDING_FILE"` `"YOUTUBE_STORE_VALIDATION"`
`exitCode`	`number \| null` Code de sortie facultatif d’une commande de traitement ayant échoué. Les détails de diagnostic peuvent varier ; utilisez le code `error` pour la gestion des erreurs par programmation.
`exitSignal`	`null \| string` Signal facultatif ayant mis fin à une commande de traitement. Les détails du diagnostic peuvent varier ; utilisez le code `error` pour la gestion programmatique des erreurs.
`file`	`string`
`headers`	`object` Schéma de la propriété supplémentaire `n’importe quelle valeur`
`is_private_address`	`boolean`
`name`	`string`
`numRetries`	`number`
`ok`	`null`
`playwright_error_code`	`string`
`reason`	`null \| string \| number \| boolean \| Array<n’importe quelle valeur> \| object` Détails de diagnostic facultatifs. Ne supposez pas que cette valeur est une chaîne de caractères et ne l’affichez pas directement ; utilisez `message` pour le texte lisible par un humain. Les détails de diagnostic peuvent varier ; utilisez le code `error` pour la gestion programmatique des erreurs. N’importe lequel des schémas suivants peut s’appliquer : `null` `string` `number` `boolean` Array<n’importe quelle valeur> `Array<n’importe quelle valeur>` Schéma d’un élément de tableau `n’importe quelle valeur` object `object` Schéma de la propriété supplémentaire `n’importe quelle valeur`
`response_code`	`number \| null`
`retries`	`number`
`retryable`	`boolean`
`stderr`	`string` Sortie de diagnostic facultative produite par une commande de traitement, destinée au dépannage. Les détails du diagnostic peuvent varier ; utilisez le code `error` pour gérer les erreurs par programmation.
`stdout`	`string` Sortie standard facultative d’une commande de traitement, destinée au dépannage. Les détails de diagnostic peuvent varier ; utilisez le code `error` pour gérer les erreurs par programmation.
`url`	`string`
`url_host`	`null \| string`

Réponse d’erreur

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Au moins une de ces propriétés est requise : error, message, reason

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`assembly_id`	`string`
`error`	`string` (longueur minimale : 1)
`http_code`	`number \| string` `number` `string` Motif de validation (expression régulière) ^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff][+-]?0(?:0(?:[^0-9]\|$)\|(?:[1-9][0-9]{0,307}\|1(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-5][0-9]{4}\|7976[0-8][0-9]{3}\|79769[0-2][0-9]{2}\|7976930[0-9]{1}\|7976931[0-2])[0-9]{300}\|79769313(?:(?:[0-3][0-9]{7}\|4[0-7][0-9]{6}\|48[0-5][0-9]{5}\|486[0-1][0-9]{4}\|4862[0-2][0-9]{3}\|486230[0-9]{2}\|486231[0-4][0-9]{1}\|4862315[0-7])[0-9]{292}\|48623158(?:(?:0[0-6][0-9]{6}\|07[0-8][0-9]{5}\|079[0-2][0-9]{4}\|0793[0-6][0-9]{3}\|07937[0-1][0-9]{2}\|079372[0-7][0-9]{1}\|0793728[0-8])[0-9]{284}\|07937289(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-3][0-9]{5}\|7140[0-4][0-9]{3}\|71405[0-2][0-9]{2}\|7140530[0-2])[0-9]{276}\|71405303(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-4][0-9]{5}\|4150[0-6][0-9]{3}\|41507[0-8][0-9]{2}\|415079[0-8][0-9]{1}\|4150799[0-2])[0-9]{268}\|41507993(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-2][0-9]{5}\|413[0-1][0-9]{4}\|4132[0-6][0-9]{3}\|413270[0-9]{2})[0-9]{260}\|41327100(?:(?:[0-2][0-9]{7}\|3[0-6][0-9]{6}\|37[0-7][0-9]{5}\|378[0-1][0-9]{4}\|3782[0-5][0-9]{3}\|37826[0-8][0-9]{2}\|378269[0-2][0-9]{1}\|3782693[0-5])[0-9]{252}\|37826936(?:(?:0[0-9]{7}\|1[0-6][0-9]{6}\|17[0-2][0-9]{5}\|173[0-6][0-9]{4}\|1737[0-6][0-9]{3}\|17377[0-7][0-9]{2}\|173778[0-8][0-9]{1}\|1737789[0-7])[0-9]{244}\|17377898(?:(?:0[0-3][0-9]{6}\|04[0-3][0-9]{5}\|044[0-3][0-9]{4}\|0444[0-8][0-9]{3}\|04449[0-5][0-9]{2}\|044496[0-7][0-9]{1}\|0444968[0-1])[0-9]{236}\|04449682(?:(?:[0-8][0-9]{7}\|9[0-1][0-9]{6}\|92[0-6][0-9]{5}\|927[0-5][0-9]{4}\|9276[0-3][0-9]{3}\|92764[0-6][0-9]{2}\|927647[0-4][0-9]{1})[0-9]{228}\|92764750(?:(?:[0-8][0-9]{7}\|9[0-3][0-9]{6}\|94[0-5][0-9]{5}\|946[0-5][0-9]{4}\|9466[0-3][0-9]{3}\|94664[0-8][0-9]{2}\|94664900)[0-9]{220}\|94664901(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-6][0-9]{4}\|7977[0-4][0-9]{3}\|79775[0-7][0-9]{2}\|797758[0-6][0-9]{1}\|7977587[0-1])[0-9]{212}\|79775872(?:(?:0[0-6][0-9]{6}\|070[0-8][0-9]{4}\|0709[0-5][0-9]{3}\|07096[0-2][0-9]{2}\|070963[0-2][0-9]{1})[0-9]{204}\|07096330(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-5][0-9]{5}\|286[0-3][0-9]{4}\|28640[0-9]{3}\|28641[0-5][0-9]{2}\|286416[0-5][0-9]{1}\|2864166[0-8])[0-9]{196}\|28641669(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-7][0-9]{5}\|288[0-6][0-9]{4}\|2887[0-8][0-9]{3}\|288790[0-9]{2}\|2887910[0-8])[0-9]{188}\|28879109(?:(?:[0-3][0-9]{7}\|4[0-5][0-9]{6}\|46[0-4][0-9]{5}\|465[0-4][0-9]{4}\|4655[0-4][0-9]{3}\|46555[0-4][0-9]{2}\|465555[0-3][0-9]{1}\|4655554[0-6])[0-9]{180}\|46555547(?:(?:[0-7][0-9]{7}\|8[0-4][0-9]{6}\|850[0-9]{5}\|851[0-8][0-9]{4}\|8519[0-3][0-9]{3}\|851940[0-3][0-9]{1})[0-9]{172}\|85194040(?:(?:[0-1][0-9]{7}\|2[0-5][0-9]{6}\|26[0-2][0-9]{5}\|2630[0-5][0-9]{3}\|26306[0-4][0-9]{2}\|263065[0-6][0-9]{1}\|2630657[0-3])[0-9]{164}\|26306574(?:(?:[0-7][0-9]{7}\|8[0-7][0-9]{6}\|88[0-5][0-9]{5}\|886[0-6][0-9]{4}\|88670[0-9]{3}\|88671[0-4][0-9]{2}\|8867150[0-4])[0-9]{156}\|88671505(?:(?:[0-7][0-9]{7}\|8[0-1][0-9]{6}\|820[0-5][0-9]{4}\|8206[0-7][0-9]{3}\|820680[0-9]{2}\|820681[0-8][0-9]{1})[0-9]{148}\|82068190(?:(?:[0-7][0-9]{7}\|8[0-8][0-9]{6}\|890[0-1][0-9]{4}\|8902000[0-6])[0-9]{140}\|89020007(?:(?:0[0-7][0-9]{6}\|08[0-2][0-9]{5}\|083[0-7][0-9]{4}\|0838[0-2][0-9]{3}\|08383[0-5][0-9]{2}\|083836[0-6][0-9]{1}\|0838367[0-5])[0-9]{132}\|08383676(?:(?:[0-1][0-9]{7}\|2[0-6][0-9]{6}\|27[0-2][0-9]{5}\|273[0-7][0-9]{4}\|2738[0-4][0-9]{3}\|27385[0-3][0-9]{2}\|273854[0-7][0-9]{1}\|2738548[0-3])[0-9]{124}\|27385484(?:(?:[0-4][0-9]{7}\|5[0-7][0-9]{6}\|580[0-9]{5}\|581[0-6][0-9]{4}\|5817[0-6][0-9]{3}\|581770[0-9]{2}\|5817710[0-9]{1}\|5817711[0-4])[0-9]{116}\|58177115(?:(?:[0-2][0-9]{7}\|30[0-9]{6}\|31[0-6][0-9]{5}\|317[0-5][0-9]{4}\|3176[0-3][0-9]{3}\|31764[0-3][0-9]{2}\|317644[0-6][0-9]{1}\|3176447[0-4])[0-9]{108}\|31764475(?:(?:[0-6][0-9]{7}\|7[0-2][0-9]{6}\|730[0-1][0-9]{4}\|7302[0-6][0-9]{3}\|7302700[0-5])[0-9]{100}\|73027006(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-4][0-9]{5}\|985[0-4][0-9]{4}\|9855[0-4][0-9]{3}\|98555[0-6][0-9]{2}\|9855570[0-9]{1}\|9855571[0-2])[0-9]{92}\|98555713(?:(?:[0-5][0-9]{7}\|6[0-5][0-9]{6}\|66[0-8][0-9]{5}\|669[0-4][0-9]{4}\|6695[0-8][0-9]{3}\|66959[0-5][0-9]{2}\|669596[0-1][0-9]{1}\|6695962[0-1])[0-9]{84}\|66959622(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-1][0-9]{5}\|842[0-8][0-9]{4}\|84290[0-9]{3}\|84291[0-3][0-9]{2}\|842914[0-7][0-9]{1}\|84291480)[0-9]{76}\|84291481(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-5][0-9]{5}\|9860[0-7][0-9]{3}\|98608[0-2][0-9]{2}\|986083[0-3][0-9]{1}\|9860834[0-8])[0-9]{68}\|98608349(?:(?:[0-2][0-9]{7}\|3[0-5][0-9]{6}\|36[0-3][0-9]{5}\|364[0-6][0-9]{4}\|3647[0-4][0-9]{3}\|36475[0-1][0-9]{2}\|364752[0-8][0-9]{1}\|3647529[0-1])[0-9]{60}\|36475292(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-8][0-9]{5}\|7190[0-6][0-9]{3}\|71907[0-3][0-9]{2}\|7190740[0-9]{1}\|7190741[0-5])[0-9]{52}\|71907416(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-3][0-9]{5}\|844[0-3][0-9]{4}\|8444[0-2][0-9]{3}\|84443[0-5][0-9]{2}\|844436[0-4][0-9]{1}\|8444365[0-4])[0-9]{44}\|84443655(?:(?:0[0-9]{7}\|10[0-6][0-9]{5}\|1070[0-3][0-9]{3}\|10704[0-2][0-9]{2}\|107043[0-3][0-9]{1}\|1070434[0-1])[0-9]{36}\|10704342(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|710[0-9]{5}\|711[0-4][0-9]{4}\|7115[0-4][0-9]{3}\|71155[0-8][0-9]{2}\|711559[0-5][0-9]{1}\|7115596[0-8])[0-9]{28}\|71155969(?:(?:[0-8][0-9]{7}\|9[0-4][0-9]{6}\|950[0-7][0-9]{4}\|95080[0-8][0-9]{2}\|950809[0-2][0-9]{1})[0-9]{20}\|95080930(?:(?:[0-3][0-9]{7}\|4[0-1][0-9]{6}\|42[0-7][0-9]{5}\|428[0-7][0-9]{4}\|428800[0-9]{2}\|428801[0-6][0-9]{1}\|4288017[0-6])[0-9]{12}\|42880177(?:(?:[0-8][0-9]{7}\|90[0-3][0-9]{5}\|9040[0-9]{4}\|9041[0-6][0-9]{3}\|90417[0-3][0-9]{2}\|904174[0-3][0-9]{1}\|9041744[0-8])[0-9]{4}\|90417449(?:(?:[0-6][0-9]{3}\|7[0-6][0-9]{2}\|77[0-8][0-9]{1}\|7790)\|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]\|$))
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.
`reason`	`null \| string \| number \| boolean \| Array<n’importe quelle valeur> \| object` N’importe lequel des schémas suivants peut s’appliquer : `null` `string` `number` `boolean` Array<n’importe quelle valeur> `Array<n’importe quelle valeur>` Schéma d’un élément de tableau `n’importe quelle valeur` object `object` Schéma de la propriété supplémentaire `n’importe quelle valeur`

HTTP 400

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Erreurs nommées et format général des erreurs

error: "INVALID_PARAMS_FIELD"

Le champ params fourni est invalide : il contient du JSON invalide.

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error` obligatoire	`string` (toujours : "INVALID_PARAMS_FIELD")
`http_code`	`number` (toujours : 400)
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.

Format général des erreurs

Consultez les champs généraux des réponses d’erreur.

Pour en savoir plus sur la réponse, veuillez consulter notre documentation sur la réponse Assembly Status.

Créer une nouvelle Assembly

Exemple de requête

Authentification

Paramètres de requête facultatifs pour la réponse

Champs de formulaire multipart

Clés prises en charge dans le champ params

Paramètres de requête par méthode d’authentification

Réponse

Succès 2xx

Réponse d’erreur

HTTP 400

Clés prises en charge dans le champ `params`