Compartir a través de

Validación del servicio de elementos de inventario

  • Artículo

El inventory-list/validate-inventory-item servicio se usa para determinar si Xandr admite actualmente los identificadores de la agrupación de aplicaciones o las direcciones URL sin procesar (dominios o aplicaciones) que proporcione en las listas de inventario. Este servicio validará si estas direcciones URL e identificadores de aplicación están correctamente formados y admitidos, así como indicarán si infringen las directivas de Xandr.

API de REST

Http (método) Endpoint Description
POST https://api.appnexus.com/inventory-list/validate-inventory-item
(JSON de lista de inventario)		 Valide una lista de elementos de inventario.

Campos JSON

Campo Tipo Descripción
is_valid booleano Indica si la aplicación o el dominio están correctamente formados (por ejemplo, usa un protocolo HTTP o HTTPS). Si truees , se forma correctamente.
is_supported booleano Indica si Xandr admite actualmente la aplicación o dominio (es decir, si se ha auditado). Si truees , se admite.
url string Dirección URL sin procesar o identificador de lote de aplicaciones que proporcionó para que se validara el elemento (dominio o aplicación).
Obligatorio activado:POST
inventory_url string Dirección URL de la aplicación o dominio una vez validada.
inventory_url_id Entero Identificador asignado a una dirección URL de inventario. Si inventory_url_id tiene un null valor, significa que el inventario aún no se ha aprobado.
audit_status enumeración Estado de auditoría actual del dominio o la aplicación. Los posibles valores son:
- audited: el dominio o la aplicación ha superado la auditoría de inventario de Xandr.
- rejected: el dominio o la aplicación han producido un error en la auditoría de inventario de Xandr (debido a infracciones de la directiva de Xandr).
app_name string Nombre de la aplicación móvil. Si el elemento de inventario es un dominio, aparece un null valor.
rejection_reason string El motivo por el que este dominio o aplicación infringe las directivas Xandr (por ejemplo, Violence) si el audit_status campo está establecido rejecteden . Si el audit_status campo no está establecido en rejected, este campo será null.
is_parent_domain booleano Indica si el dominio también incluye subdominios.

Ejemplo

Validación de una lista de elementos de inventario

En este ejemplo, se valida una lista de elementos de inventario.

$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 
      }
    ]
  }
}