Nachrichtenabruf-API

Die API-Schicht unterstützt die Nachrichten-Rückruf-Funktion.

Authentifizierung

Weitere Informationen finden Sie im Abschnitt [Authentifizierungsmethoden] in der Übersicht zur REST-API.

DELETE v4/push/withdraw/{msg_id}

Der Rückruf ist nur für Nachrichten möglich, die innerhalb eines Tages versendet wurden.
Mehrfache Rückrufe sind nicht möglich.

Name	Erforderlich	Beschreibung
msg_id	Ja	Die von der Nachrichtenübermittlung zurückgegebene `msg_id` (Nachrichten-ID)

Request Header

DELETE /v4/push/withdraw/1828256757 Authorization: Basic (Base64-Auth-String) Accept: application/json

              
              DELETE /v4/push/withdraw/1828256757
 Authorization: Basic (Base64-Auth-String)
 Accept: application/json

Diesen Codeblock im schwebenden Fenster anzeigen

Erfolgreiche Rückmeldung

< HTTP/1.1 200 OK < Content-Type: application/json { "request_id": "", "msg_id": "1180003" }

              
              < HTTP/1.1 200 OK
< Content-Type: application/json
{
    "request_id": "",
    "msg_id": "1180003"
}

Diesen Codeblock im schwebenden Fenster anzeigen

Fehlermeldung

HTTP/1.1 400 BAD REQUEST Content-Type: application/json; charset=utf-8

              
              HTTP/1.1 400 BAD REQUEST
 Content-Type: application/json; charset=utf-8

Diesen Codeblock im schwebenden Fenster anzeigen

{ "error": { "code": 21003, "message": "Parameter value is invalid,msg_id not exist" } }

              
              {
    "error": {
        "code": 21003,
        "message": "Parameter value is invalid,msg_id not exist"
    }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Code	HTTP	Beschreibung	Fehlermeldung	Detaillierte Erklärung
None	200	Erfolgreiche Rückgabe (Success)	nil	Erfolgsstatuscode
21003	400	Parameterfehler	Parameter value is invalid,msg_id not exist	Parameterwert ist ungültig, einschließlich spezifischer Fehlermeldung