Fehler

Die Anzeigenplatzierungs-API kann die folgenden Antwortcodes zurückgeben:

Code	Beschreibung	Erläuterung
400	Schlechte Anfrage	Zeigt an, dass die gesendeten Daten falsch formatiert sind.
200	OK	Dies bedeutet, dass entweder die Anfrage korrekt ist oder dass einige Zonen nicht gefunden werden konnten. In der Antwort wird angegeben, um welche Zonen es sich handelt.
500	Interner Fehler	Zeigt an, dass ein interner Fehler aufgetreten ist, aber die Ursache unbekannt ist. Wenden Sie sich an Ihren Kundenbetreuer oder an Customer Success, um Hilfe zu erhalten.

400 Fehlermeldungen

Nachricht	Erläuterung
Missgebildeter JSON-Body	Syntax-Fehler
Nicht unterstützter Anfragetyp	Falsches Anfrageverb verwendet
Dieses Feld fehlt	Es fehlt ein Pflichtfeld
Dieses Feld wurde nicht erwartet	Der Anfrage wurde ein nicht erkannter Parameter hinzugefügt
Dieser Wert sollte vom Typ X sein	Falsches Format für einen bestimmten Parameter verwendet

400 Fehler Beispiel

Anfrage:

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

Antwort:

{
    "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 Fehlermeldungen

Nachricht	Erläuterung
Zonen-ID nicht gefunden	Die Zonen-ID kann nicht gefunden werden ODER die Domäne des Endpunkts entspricht nicht dem angeforderten Anzeigenformat
Zone oder Standort nicht gültig	Die Zone oder der Publisher ist gesperrt.

200 Fehler Beispiel

In diesem Beispiel haben wir Anzeigen für mehrere Zonen angefordert, und einige von ihnen haben Fehler zurückgegeben.

Anfrage:

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

Antwort:

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

zonen.daten null

In sehr seltenen Fällen gibt eine Anfrage für einen Anzeigenbereich eine korrekte Antwort zurück, aber das Feld "Daten" ist leer. Dies bedeutet, dass das System keine Anzeigen gefunden hat, die der gegebenen Anfrage entsprechen, je nach Gebietsschema des Benutzers, Browser usw.