Documentation

Référence API

Consulter une image de référence

GET/v1/image-assets/{asset_id}

Même compte et même Key ; ressource expirée : 410 ; suppression pendant une référence par tâche inachevée : 409.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

Paramètres de chemin

  • asset_idstringObligatoire

    ID de ressource image ia_ téléversée avec la même Key.

Réponses et erreurs

HTTP 200

Image de référence consultée

application/json

Type
object
Champs obligatoires
idmime_typesize_byteswidthheightexpires_at
  • file_idstringFacultatif

    ID public du fichier hébergé du même compte et de la même Key.

  • idstringObligatoire

    Identifiant public de l'objet, utilisé dans son chemin de détails.

  • mime_typestringObligatoire

    Type MIME du fichier vérifié.

  • size_bytesintegerObligatoire

    Taille du fichier en octets.

  • widthintegerObligatoire

    Largeur de l'image en pixels.

  • heightintegerObligatoire

    Hauteur de l'image en pixels.

  • expires_atintegerObligatoire

    Secondes Unix ; 0 signifie sans expiration fixe. Le téléversement est lié à un fichier hébergé ; lecture avec le même compte et la même Key.

HTTP 400

Champs ou paramètres de requête invalides.

application/json

Type
object
Champs obligatoires
error

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type
object
Champs obligatoires
error

HTTP 403

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 404

Objet/capacité indisponible ou fonctionnalité désactivée.

application/json

Type
object
Champs obligatoires
error

HTTP 409

Conflit d'idempotence/devis, objet non prêt ou encore référencé.

application/json

Type
object
Champs obligatoires
error

HTTP 410

Image de référence expirée ou supprimée (asset_expired).

application/json

Type
object
Champs obligatoires
error

HTTP 429

Limitation de débit des requêtes/de la file.

application/json

Type
object
Champs obligatoires
error

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type
object
Champs obligatoires
error

HTTP 503

Service, tarification ou stockage indisponible.

application/json

Type
object
Champs obligatoires
error