Leer en inglés

Compartir a través de


Servicio seat

Importante

Esta característica se encuentra actualmente en versión beta cerrada. Si está interesado en participar, póngase en contacto con su representante de Xandr.

El producto De identificación de asiento del comprador permite a los licitadores externos pujar con sus identificadores de comprador personalizados en lugar de usar identificadores de miembro Xandr. Esto permite a los licitadores externos utilizar los identificadores de comprador de sus propios sistemas al pujar por el inventario de Xandr y permitirá la creación de informes y acuerdos sin problemas.

El servicio de puestos es un nuevo servicio de API que se usa para registrar nuevos puestos para un postor. Esto se puede hacer manualmente mediante llamadas post a la API o en tiempo real cuando un licitador puja con un nuevo identificador de puesto en la respuesta de la oferta.

Resumen

El Servicio de asientos se usa para almacenar los identificadores de asiento de un postor. Estos identificadores de asiento se usarán en la respuesta de la puja y se registrarán en los informes de transacciones.

Rest API

Http (método) Endpoint Description
GET https://api.adnxs.com/seat/BIDDER_ID Para ver todos los asientos adjuntos a su postor
GET https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID Para ver un asiento existente mediante el identificador de asiento de API
GET https://api.adnxs.com/seat?bidder_id=BIDDER_ID&code=SEATCODE Para ver un asiento existente con el identificador de asiento del postor de API
POST https://api.adnxs.com/seat/BIDDER_ID Agregar un nuevo asiento
PUT https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID Modificación de un asiento existente mediante el identificador de asiento de API
PUT https://api.adnxs.com/seat?bidder_id=BIDDER_ID&co6de=SEATCODE Modificación de un asiento existente mediante el identificador de asiento del licitador

Campos JSON

Campo Tipo Description
bidder_id Entero El identificador del licitador. Se trata de un campo de solo lectura.
code string Id. de asiento del licitador.
id Entero El identificador del asiento. Se trata de un campo de solo lectura.
name string Nombre del comprador para este asiento.

Nota: En los puestos registrados automáticamente, la convención de nomenclatura estándar se seat_code (nombre del licitador)

Ejemplos

En las siguientes llamadas API de ejemplo se muestra cómo puede cargar nuevos asientos o editar los existentes:

Carga de un nuevo asiento

$ cat seats.json
 
{
 
    "seats": [{
            "bidder_id": 1,
            "code": "sdfg54VVsh",
            "name": "sdfg54VVsh(Bidder)"
        },
        {
            "bidder_id": 129,
            "code": "54Gfa762Gbse",
            "name": "54Gfa762Gbse(Bidder)"
        }
    ]
}
 
$ curl -b cookies -c cookies -X POST -d @seats.json "https://api.adnxs.com/seat/1"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "sdfg54VVsh(Bidder)"
            },
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}

Actualización de un asiento existente: cambio del nombre del asiento

$ cat seats.json
 
{
 
    "seats": [{
            "bidder_id": 1,
            "code": "sdfg54VVsh",
            "name": "Bidder seat name"
        }
    ]
}
 
$ curl -b cookies -c cookies -X PUT -d @seats.json "https://api.adnxs.com/seat/1/11"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "Bidder seat name"
            }
        ]
    }
}

Ver un asiento existente

$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1/22"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}

Ver todos los puestos para un postor específico

$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1"
 {
    "response": {
        "status": "OK",
        "num_elements": 100,
        "seats": [
            {
                "bidder_id": 1,
                "code": "sdfg54VVsh",
                "created_on": "2018-12-13 15:31:13",
                "id": 11,
                "last_activity": "2018-12-13 15:31:13",
                "name": "sdfg54VVsh(Bidder)"
            },
            {
                "bidder_id": 1,
                "code": "54Gfa762Gbse",
                "created_on": "2018-12-13 17:09:26",
                "id": 22,
                "last_activity": "2018-12-13 17:09:26",
                "name": "54Gfa762Gbse(Bidder)"
            }
        ]
    }
}