Récupérer les types d’informations d’identification de Template

Répertorie les types d’informations d’identification de Template pris en charge par Transloadit.

Exécutez l’exemple de requête ci-dessous pour découvrir les champs actuels des services. Dans la réponse, sélectionnez votre service sous types, puis examinez types[service].fields. Par exemple, types.s3.fields décrit les champs acceptés pour les informations d’identification S3.

Utilisez ces noms de champs dans l’objet content lors de la création ou de la mise à jour des informations d’identification. Un champ dont requiredOnCreate vaut true doit avoir une valeur non vide lors de la création des informations d’identification. Un champ dont requiredOnUpdate vaut true doit avoir une valeur non vide chaque fois que vous fournissez content lors d’une mise à jour. Si l’un de ces indicateurs est absent ou vaut false, le champ concerné n’est pas obligatoire pour l’opération correspondante. Consultez la section Mise à jour des informations d’identification pour connaître le comportement en cas d’omission de content et les règles de préservation des secrets.

Le schéma téléchargeable décrit la structure de cette réponse, et non le catalogue actuel des services ; la réponse à la requête de découverte authentifiée fournit les noms des champs, leurs explications et leurs exigences.

Exemple de requête

Les Workspaces résiliés ne peuvent pas créer de nouveaux jetons porteurs. Ce point de terminaison reste accessible avec une Auth Key active existante : utilisez la procédure de lecture signée à la place de la configuration du jeton ci-dessous. La clé doit accorder les portées requises par ce point de terminaison.

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

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')"; 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

curl --fail-with-body -sS --request GET --get \
  --url "https://api2.transloadit.com/template_credentials/types" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={}'

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

Les requêtes signées nécessitent à la fois une signature et un horodatage params.auth.expires situé dans le futur. Les jetons porteurs ne nécessitent ni l’un ni l’autre.

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.