Errores

La API de inserción de anuncios puede devolver los siguientes códigos de respuesta:

Código	Descripción	Explicación
400	Mala petición	Indica que los datos enviados tienen un formato incorrecto.
200	OK	Esto indica que, o bien la solicitud es correcta, o bien hay algunas zonas que no se han podido encontrar. La respuesta le indicará de qué zonas se trata.
500	Error interno	Indica que se ha producido un error interno pero se desconoce la causa. Póngase en contacto con su gestor de cuenta o con Customer Success para obtener ayuda.

mensajes de error 400

Mensaje	Explicación
Cuerpo JSON malformado	Error de sintaxis
Tipo de solicitud no admitida	Verbo de solicitud incorrecto
Falta este campo	Falta un campo obligatorio
Este campo no estaba previsto	Se ha añadido un parámetro no reconocido a la solicitud
Este valor debe ser de tipo X	Formato incorrecto utilizado para un parámetro específico

ejemplo de error 400

Petición:

{
    "user": {
        "testing": false
    },
    "zones": [
        {
            "id": "12345"
        }
    ]
}

Respuesta:

{
    "errors": [
        {
            "[user][ua]": "This field is missing."
        },
        {
            "[user][testing]": "This field was not expected."
        },
        {
            "[zones][0]": "[id] This value should be of type int."
        }
    ]
}

200 Mensajes de error

Mensaje	Explicación
Zona no encontrada	No se encuentra el identificador de zona O el dominio del punto final no se corresponde con el formato de anuncio solicitado
Zona o sitio no válido	La zona o el Editor están bloqueados.

ejemplo de error 200

En este ejemplo, hemos solicitado anuncios para varias zonas y algunos de ellos han devuelto errores.

Petición:

{
    "user": {
        "ip": "179.127.135.233",
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:81.0) Gecko/20100101 Firefox/81.0"
    },
    "zones": [
        {
            "id": 1
        },
        {
            "id": 2
        },
        {
            "id": 3
        }   
    ]
}

Respuesta:

{
    "zones": [
        null,
        {
            "idzone": 2,
            "type": "banner",
            "data": {
                "url": "https://main.example.rocks/click.php?data=H4sIAAAAAAAAA0WPO27DQAxEr.LG7YK__bBMk8ZFzrArrZAiQQLYgFzM4UNZRUCCIMjhw_ACI69SHNYIn4_H7_2qb1d5j9z3Pc1nX.9p.fkGQAAXUvGj4n_D1RNLTaw5iSpgVoQbcbCV2CsytZgyNACBCZASPSUTOAIsSQ1qlFsOVWXeNKDDZ1cuS56j5o1Gtz7K1BonhPHVI09nB_GC1_gMtcwcTl4dHd8dIqdT2k6h4eOG5kK1.7Kts.ncyuijs64unlerZf4BvX2zxCABAAA-",
                "impression": "https://syndication.example.rocks/cimp.php?t=imp&api=1&data=H4sIAAAAAAAAAzVPSW4DMQz7Sj8wBrV5ya1FX9CiD7An9qlFD73MQY+PkmlEG5ZMwqQZjI2wMb0QLpovKk6lJeKSSCyxiL99vLqSz6Nf/9L+++MqrFKeRy3aqrlCQK24oUbfCufmqpmpgpyyiyMgCqsWr8WQtHqBf32+P3aonF2Agw3R320pRJyQyBtc4xJHUJxEvRAtiaijzS6Ud5uj2MLo2keekevuMb57rEdonEj4p54QNaL45UbngHvwKPiDjqqnPPKpwstqmHNera9OZe053DCHrdGXGPUbbttiKlIBAAA=",
                "image": "https://static.example.rocks/library/432437/42ec0144a74a1663f2973ad3070234f8e5633855.jpg"
            }
        },
        null
    ],
    "errors": {
        "0": [
            "Zone 1 not found"
        ],
        "2": [
            "Zone 3 not found"
        ]
    }
}

zonas.datos null

En muy raras ocasiones, una solicitud de zona publicitaria devolverá una respuesta correcta, pero el campo "datos" será nulo. Esto significa que el sistema no ha encontrado anuncios que satisfagan la solicitud dada la configuración regional del usuario, el navegador, etc.