Erreurs

L'API de placement publicitaire peut renvoyer les codes de réponse suivants :

Code	Description	Explication
400	Mauvaise demande	Indique que les données envoyées sont mal formatées.
200	OK	Cela indique que la demande est correcte ou que certaines zones n'ont pas pu être trouvées. La réponse vous indiquera de quelles zones il s'agit.
500	Erreur interne	Indique qu'une erreur interne s'est produite mais que la cause est inconnue. Contactez votre gestionnaire de compte ou Customer Success pour obtenir de l'aide.

400 Messages d'erreur

Message	Explication
Corps JSON malformé	Erreur de syntaxe
Type de demande non pris en charge	Utilisation d'un mauvais verbe de requête
Ce champ est manquant	Un champ obligatoire est manquant
Ce champ n'était pas prévu	Un paramètre non reconnu a été ajouté à la demande
Cette valeur doit être de type X	Mauvais format utilisé pour un paramètre spécifique

exemple d'erreur 400

Demande :

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

Réponse :

{
    "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 Messages d'erreur

Message	Explication
L'identifiant de la zone n'a pas été trouvé	L'identifiant de la zone est introuvable OU le domaine du point de terminaison ne correspond pas au format publicitaire demandé
Zone ou site non valide	La zone ou l'éditeur est bloqué.

exemple d'erreur 200

Dans cet exemple, nous avons demandé des annonces pour plusieurs zones et certaines d'entre elles ont renvoyé des erreurs.

Demande :

{
    "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
        }   
    ]
}

Réponse :

{
    "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"
        ]
    }
}

zones.data null

Il arrive très rarement qu'une demande de zone publicitaire renvoie une réponse correcte, mais que le champ "données" soit nul. Cela signifie que le système n'a trouvé aucune publicité susceptible de répondre à la demande, compte tenu de la localisation de l'utilisateur, de son navigateur, etc.