Ta emot leveransrapporter

Beskrivning

Om en URL för leveransrapporter har angets när en batch skapas, kommer rapporter över statusuppdateringar att skickas till den URL så fort de finns tillgängliga. Innehållet i dessa rapporter är beskrivna nedan.

Systemet skickar ut rapporter genom metoden POST och förväntar sig ett 200 OK i respons om rapporten tagits emot korrekt. Om någon responsen består av en annan status (exempelvis en error status) kommer ett nytt försök att göras vid ett senare tillfälle. Dessa omförsök repeteras med 10 minuters mellanrum till ett 200 OK har tagits emot, upp till 10 gånger. När dessa 10 försök har paserat utan en lyckad status kommer rapporten att raderas.

Rapport Payload

{
    "id": "5c613848879973045cf39ac4",
    "batchId": "5c613848879973045cf39ac3",
    "recipient": "456189040623",
    "code": 102,
    "duration": 0,
    "created": "2018-10-23T17:43:21Z",
    "segments": 2,
    "price": 0.082,
    "currency": "sek",
    "reference": "A client reference"
}

Fält för Payload

Fältnamn Typ Beskrivning och Villkor Exempel
id String Det inkommande meddelandets ID. 

"id": "5bcf4324ee47dee41a9dbb13"
batchId String ID för Det inkommande meddelandets överliggande batch (Meddelanden kan inte existera utan en överliggande batch). 

"batchId": "5c613848879973045cf39ac3"
batchId String Konto-ID för SMS-kontot som äger meddelandet. 

"owner": "ip1-XXXXX"
recipient String Avsändar-ID för det inkommande meddelandets upphovsman. 

"sender": "46712345678"
code Integer Den nsenaste statuskoden för meddelandet. För mer information om våra statuskoder, se avsnittet om statuskoder 

"code": 102
duration Integer Visar om meddelandets status är permanent/slutlig. Om så är fallet kommer detta vara den sista rapporten som skickas gällande detta meddelande. 

"duration": 0
created String När statusuppdateringen inträffade (med andra ord, när rapporten genererades). 

"created": "2018-10-23T17:43:21Z"
segments String I de fall meddelandet består av fler tecken än teckengränsen för ett SMS kommer meddelandet att delas upp i flera SMS, även kallat konkatenerade SMS. Den här egenskapen indikerar om hur många SMS som behövs för att kunna skicka meddelandet 

"segments": 2,
price Integer Hela meddelandets pris. Om du vill få ett pris på ett enskilt SMS kan du dela sumeringen av priset på antal segment i meddelandet. 

"price": 0.082,
currency String Vilken valuta som priset anges i. 

"currency": "sek",
reference String Detta är en egenskap som tillåter användaren att sätta ett eget ID eller referens om lagring av standard-genererade ID´n ogillas. 

 "reference": "A client reference"