Bei einem Fehler wird erwartet, dass der DPA einen HTTP-Statuscode zusammen mit einer HTTP-Antwort zurückgibt, die ein JSON-Objekt mit weiteren Informationen zum Fehler enthalten muss. Der Fehlerantworttext MUSS eine Instanz von ErrorResponse enthalten.
{
"errorMessage": string,
"cause": enum(ErrorCause)
}
Die DPA-Fehlerantwort MUSS Folgendes entsprechen:
- Der Nutzer verwendet derzeit Roaming und die Anfrage für den Datenschutz ist für diesen Nutzer deaktiviert. Die DPA gibt einen 403-Fehler zurück, bei dem USER_ROAMING die Fehlerursache ist.
- Die DPA gibt den 404 NOT_FOUND-Fehlercode zurück, der GTAF angibt, dass der Nutzerschlüssel ungültig ist (d.h. ein nicht vorhandener Nutzerschlüssel) mit INVALID_NUMBER.
- Die DPA gibt einen 410 GONE-Fehlercode mit BAD_CPID als Fehlerursache zurück. Dies weist auf GTAF hin, dass der Client einen neuen Nutzerschlüssel erhalten sollte, wenn key_type = CPID und die CPID abgelaufen ist.
- Die DPA gibt den Fehlercode 501 NOT_IMPLEMENTED zurück, der angibt, dass dieser Aufruf mit der Fehlerursache SERVICE_UNAVAILABLE nicht unterstützt wird.
- Die DPA gibt den Fehlercode 429 TOO MANY REQUESTS with TOO_MANY_REQUESTS mit dem Retry-After-Header zurück, der angibt, dass GTAF zu viele Anfragen an den DPA sendet.
- Die DPA gibt einen CONFLICT-Fehler 409 zurück, der angibt, dass die Anfrage aufgrund eines Konflikts mit dem aktuellen Status der DPA nicht abgeschlossen werden kann.
- Der Dienst steht vorübergehend nicht zur Verfügung. Die DPA gibt den 503-SERVICE UNAVAILABLE zurück und gibt den Retry-After-Header an, der angibt, wann eine neue Anfrage ausgeführt werden kann.
- Die DPA gibt den Fehlercode 500 INTERNAL SERVER ERROR für alle anderen nicht angegebenen Fehler ERROR_CAUSE_UNSPECIFIED als Fehlerursache zurück.
Wenn während eines Kaufs Fehler auftreten, stehen die folgenden Fehlercodes für fehlgeschlagene Transaktionsergebnisse:
- Die DPA gibt den Fehlercode 400 BAD REQUEST an, der angibt, dass die gekaufte Plan-ID ungültig ist.
- Die Datenschutzaufsichtsbehörde gibt den 402 PAYMENT REQUIRED-Fehlercode zurück, der auf GTAF hinweist, dass der Nutzer nicht über ausreichend Guthaben verfügt, um den Kauf abzuschließen.
- Die DPA gibt den Fehlercode 409 CONFLICT zurück, der angibt, dass der zu kaufende Plan nicht mit dem aktuellen Produktmix des Nutzers kompatibel ist. Wenn beispielsweise gemäß der Datentarifrichtlinie des Betreibers das Mischen von Postpaid- und Prepaid-Tarifen untersagt ist, führt der Kauf eines Prepaid-Tarifs für einen Postpaid-Nutzer daher zu einem 409-KONFLIKT-Fehler.
- Die DPA gibt einen 403-FORBIDDEN-Fehlercode zurück, der für GTAF angibt, dass die aktuelle Transaktion ein Duplikat einer zuvor ausgestellten Transaktion ist. Der DPA SOLLTE als Antwort die folgenden Fehler zurückgeben:
- Wenn die vorherige Transaktion ein Fehler war, geben Sie die Fehlerursache an.
- Wenn die vorherige Transaktion erfolgreich war, DUPLICATE_TRANSACTION.
- Wenn sich die vorherige Transaktion noch in der Warteschlange befindet, REQUEST_QUEUED.