Partager via

Valider le service d’élément d’inventaire

Le inventory-list/validate-inventory-item service est utilisé pour déterminer si les ID de bundle d’applications et/ou les URL brutes (domaines ou applications) que vous fournissez dans vos listes d’inventaire sont actuellement pris en charge par Xandr. Ce service vérifie si ces URL et ID d’application sont correctement formés et pris en charge, et indique s’ils violent les stratégies Xandr.

API REST

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/inventory-list/validate-inventory-item
(liste d’inventaire JSON)		 Valider une liste d’éléments d’inventaire.

Champs JSON

Champ Type Description
is_valid valeur booléenne Indique si l’application ou le domaine est correctement formé (par exemple, utilise un protocole HTTP ou HTTPS). Si truela valeur est , elle est correctement formée.
is_supported valeur booléenne Indique si l’application ou le domaine est actuellement pris en charge par Xandr (c’est-à-dire s’il a été audité). Si truela valeur est , elle est prise en charge.
url string URL brute ou ID d’offre groupée d’applications que vous avez fourni pour valider l’élément (domaine ou application).
Obligatoire sur :POST
inventory_url string URL de l’application ou du domaine une fois qu’elle a été validée.
inventory_url_id int ID affecté à une URL d’inventaire. Si inventory_url_id a une null valeur, cela signifie que l’inventaire n’a pas encore été approuvé.
audit_status enum Audit actuel status du domaine ou de l’application. Les valeurs possibles sont les suivantes :
- audited: le domaine ou l’application a passé l’audit de l’inventaire Xandr.
- rejected: le domaine ou l’application a échoué à l’audit de l’inventaire Xandr (en raison de violations de stratégie Xandr).
app_name string Nom de l’application mobile. Si l’élément d’inventaire est un domaine, une valeur s’affiche null .
rejection_reason chaîne La raison pour laquelle ce domaine ou cette application ne respecte pas les stratégies Xandr (par exemple, Violence) si le champ a la audit_status valeur rejected. Si le audit_status champ n’est pas défini sur rejected, ce champ sera null.
is_parent_domain valeur booléenne Indique si le domaine inclut également des sous-domaines.

Exemple

Valider une liste d’éléments d’inventaire

Dans cet exemple, nous validons une liste d’éléments d’inventaire.

$cat validate-inventory-item
 
{ 
    "inventory-items": [{ 
          "url": "yahoo.com"
       },
       { 
          "url": "breitbart.com"
       }
    ]
}
 
curl -b cookies -X POST -d @validate-inventory-item "https://api.appnexus.com/inventory-list/validate-inventory-item"
 
{
  "response": {
    "status": "OK",
    "inventory-items": [
      {
        "is_valid": true,
        "is_supported": true,
        "inventory_url": "yahoo.com",
        "inventory_url_id": 640,
        "app_name": null,
        "audit_status": "audited",
        "rejection_reason": null,
        "is_parent_domain": true,
        "visits": null 
      },
      {
        "is_valid": true,
        "is_supported": true,
        "inventory_url": "breitbart.com",
        "inventory_url_id": 678,
        "app_name": null,
        "audit_status": "rejected",
        "rejection_reason": "Hate Speech",
        "is_parent_domain": false,
        "visits": null 
      }
    ]
  }
}
  • Last updated on