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.
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.
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 |
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) |
En las siguientes llamadas API de ejemplo se muestra cómo puede cargar nuevos asientos o editar los existentes:
$ 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)"
}
]
}
}
$ 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"
}
]
}
}
$ 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)"
}
]
}
}
$ 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)"
}
]
}
}