App Asset Service

Remarque

Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

Il s’agit d’un service d’administration uniquement qui permet au personnel de Xandr d’ajouter des images liées à l’application à Akamai. Ce service n’est disponible pour aucun abonné ou développeur de la Place de marché des applications.

API REST

HTTP, méthode	Endpoint	Description
`POST`	`https://api.appnexus.com/app-asset`	Ajouter une image
`GET`	`https://api.appnexus.com/app-asset`	Afficher toutes les images
`GET`	`https://api.appnexus.com/app-asset?id=ID`	Afficher une image spécifique
`GET`	`https://api.appnexus.com/app-asset?plugin_id=PLUGIN_ID`	Afficher toutes les images associées à une application spécifique
`DELETE`	`https://api.appnexus.com/app-asset?id=ID`	Supprimer une image

Champs JSON

Champ	Type	Description
`id`	int	ID unique de chaque image. Obligatoire sur : `PUT` et `DELETE`, dans querystring.
`plugin_id`	int	Valeur d’ID unque du plug-in auquel cette image est associée. Obligatoire sur : `POST`
`description`	string	Texte qui décrit la ressource d’application. Par défaut : `null`
`category`	enum	Catégorie à laquelle appartient la ressource d’application. Les valeurs possibles : - `"big_icon"` - `"icon"` - `"favicon"` - `"screenshot"` Par défaut : `null` Obligatoire sur : `POST`
`width`	int	Largeur de la ressource d’application, en pixels. Par défaut : `null`
`height`	int	Hauteur de la ressource d’application, en pixels. Ce doit être au moins 400. Par défaut : `null`
`file_type`	enum	En lecture seule. Type d’image de la ressource d’application. Les valeurs possibles sont les suivantes : - `"png"` - `"jpg"` - `"gif"`. Par défaut : `null`
`last_modified`	Timestamp	En lecture seule. Date et heure de la dernière modification de l’image.
`media_url`	string	En lecture seule. URL de la ressource d’application hébergée. Par défaut : `null`
`content`	string	Contenu encodé en base 64 de la ressource d’application. Ce champ n’apparaît pas lorsque vous exécutez une `GET` commande. Obligatoire sur : `POST`
`size_in_bytes`	int	En lecture seule. Taille de la ressource d’application en octets. Cela ne peut pas dépasser 2 Mo. Par défaut : `0`

Configuration requise pour l’image

doit plugin_id être valide à partir du service de plug-in.
Le nombre de ressources d’application pour chaque plugin_id ne peut pas dépasser la limite indiquée par allowed_asset_count dans le service de plug-in. La valeur par défaut est 5.
La taille de l’image ne peut pas dépasser 2 Mo.
Le type d’image doit être .jpg, gif ou .png.
L’image doit être encodée en base 64.
La hauteur de l’image doit être d’au moins 400 px.
Les dimensions suivantes sont requises pour ces category types :
- big_icon : 150 x 175
- icône : 96 x 96
- favicon : 16 x 16
- capture d’écran : 640 x 400

Exemples

Ajouter une image

$ cat add-image.json
             {
             "app-asset": {
             "id":  "3466",
             "plugin_id": "91"
             }
             }
             $ curl -b cookies -c cookies -X PUT -d @add-image.json 'https://api.appnexus.com/app-asset'
             {
             "response":{
             "status":"OK",
             "count":1,
             "id":"3467",
             "start_element":null,
             "num_elements":null,
             "app-asset":{
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             }
             }

Afficher une image spécifique

$ curl -b cookies -c cookies 'https://api.appnexus.com/app-asset?id=3464'
             {
             "response":{
             "status":"OK",
             "count":1,
             "start_element":null,
             "num_elements":null,
             "app-asset":{
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             }
             }
             }

Afficher toutes les images

$ curl -b cookies -c cookies 'https://api.appnexus.com/app-asset'
             {
             "response":{
             "status":"OK",
             "count":3,
             "start_element":null,
             "num_elements":null,
             "app-assets":[
             {
             "id":3467,
             "plugin_id":92,
             "description":null,
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             {
             "id":3468,
             "plugin_id":91,
             "description":"This is a description of the screenshot",
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             },
             {
             "id":3469,
             "plugin_id":47,
             "description":null,
             "category":"icon",
             "width":96,
             "height":96,
             "file_type":"png",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/1b\/65\/02\/14\/1b6502147d7fa34f5a75d722fb46e4f3.png",
             "size_in_bytes":15250
             }
             ]
             }}

Afficher toutes les images associées à une application spécifique

$ curl -b cookies -c cookies 'http://sand.api.appnexus.com/app-asset?plugin_id=91' | json-pp
             {
             "response":{
             "status":"OK",
             "count":1,
             "start_element":null,
             "num_elements":null,
             "app-assets":[
             {
             "id":3468,
             "plugin_id":91,
             "description":"This is a description of the screenshot",
             "category":"screenshot",
             "width":640,
             "height":400,
             "file_type":"jpeg",
             "media_url":"http:\/\/cdn.sand-08.adnxs.net\/s\/app_asset\/11\/d7\/55\/bc\/11d755bce0f9e7539b57408de1799204.jpeg",
             "size_in_bytes":49354
             }
             ]
             }
             }

Supprimer une image

$ curl -b cookies -c cookies -X DELETE 'https://api.appnexus.com/app-asset?id=3468' |
             {
             "response":{
             "status":"OK",
             }
             }

Last updated on 2025-10-22

Partager via