{"id":417,"date":"2023-11-23T11:17:20","date_gmt":"2023-11-23T10:17:20","guid":{"rendered":"http:\/\/localhost\/wordpress\/?page_id=417"},"modified":"2026-01-08T12:21:49","modified_gmt":"2026-01-08T12:21:49","slug":"readinsms","status":"publish","type":"page","link":"https:\/\/ip1sms.com\/en\/developer\/readinsms\/","title":{"rendered":"Reading messages"},"content":{"rendered":"\n
\n
\n
\n\n\n\n

Lista Meddelanden<\/h1>\n\n\n\n

F\u00f6ruts\u00e4ttningar<\/h2>\n\n\n\n

N\u00e4r du listar meddelanden \u00e4r det alltid i kontexten av en batch. Ett meddelande kan inte existera utanf\u00f6r en batch, d\u00e4rf\u00f6r \u00e4r alltid ett meddelande placerat hierarkiskt underordnat en batch.<\/p>\n\n\n\n

\n\n\n\n

Quick start<\/h2>\n\n\n\n

Anv\u00e4nd exemplet nedan och byt ut \u201cAPI_NYCKEL\u201d mot en bearer token som du skapar i anv\u00e4ndarportalen, samt {batchId} mot ett faktiskt batch-id.<\/p>\n\n\n

\ncurl -X GET "https:\/\/api.ip1sms.com\/v2\/batches\/{batchId}\/messages" \\\n-H "Authorization: Bearer API_NYCKEL" \\\n-H "Content-Type: application\/json" \\\n<\/pre><\/div>\n\n\n
\n\n\n\n
Anrop<\/h2>\n\n\n\n
Lista en samling av meddelanden<\/h3>\n\n\n\n
Denna endpoint f\u00f6rser dig med alla meddelanden i en batch med senaste tillh\u00f6rande leveransrapporter. Sorterade efter skapad datum, kronologisk ordning.<\/p>\n\n\n\n
Endpoint: \/v2\/batches\/{batchId}\/messages<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/batches\/5bc86b6e85c7209830f96936\/messages\n<\/pre><\/div>\n\n\n
Lista ett enskilt meddelande<\/h3>\n\n\n\n
Denna endpoint f\u00f6rser dig med ett enskillt meddelande, med full historik \u00f6ver meddelandets leveransrapporter.<\/p>\n\n\n\n
Endpoint: \/v2\/batches\/{batchId}\/messages\/{messageId}<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/batches\/5bc86b6e85c7209830f96936\/messages\/5bcf4324ee47dee41a9dbb13\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anrop<\/h3>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        
F\u00e4ltnamn<\/th>\n        Oblogatoriskt<\/th>\n        Typ<\/th>\n        Beskrivning och Villkor<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
batchId<\/strong><\/td>\n        Ja<\/td>\n        String<\/code><\/td>\n        \n        Den \u00f6vergripande batchens id\n        <\/td>\n        \n          
\n5bc86b6e85c7209830f96936\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
messageId<\/strong><\/td>\n        Ja, vid listning av specifikt meddelande<\/td>\n        String<\/code><\/td>\n        \n        Ett unikt id f\u00f6r ett specifikt meddelande.\n        <\/td>\n        \n          
\n5bcf4324ee47dee41a9dbb13\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
\n\n\n\n
Respons<\/h2>\n\n\n\n
Exempel p\u00e5 responsdata<\/h3>\n\n\n\n
Nedan hittar du ett exempel p\u00e5 respons fr\u00e5ne tt lyckat anrop till endpointen \/v2\/batches\/{batchId}\/messages\/{messageId}<\/strong>, allts\u00e5 ett GET anrop f\u00f6r att lista ett specifikt meddelande. Se under rubriken F\u00e4lt f\u00f6r responsdata<\/a> f\u00f6r en detaljerad beskrivning av samtliga f\u00e4lt i responsen.<\/p>\n\n\n
\n{\n    "id": "5bcf4324ee47dee41a9dbb13",\n    "batchId": "5bc86b6e85c7209830f96936",\n    "owner": "ip1-XXXXX",\n    "sender": "iP1",\n    "recipient": "456189040623",\n    "body": "Hi my name is earl",\n    "direction": "mt",\n    "segments": 1,\n    "type":"SMS",\n    "datacoding": "ucs",\n    "priority": 1,\n    "price": 0.0416,\n    "currency": "EUR",\n    "statuses": [\n        {\n            "created": "2018-10-23T17:43:21Z",\n            "code": 201,\n            "duration": 0\n        }\n    ],\n    "modified": "2018-10-23T17:43:19Z",\n    "reference": "A client reference",\n    "mcc": "431",\n    "mnc": "20"\n}\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r responsdata<\/h3>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        \n        \n        \n        \n      \n        \n        \n        \n        \n        \n        \n        \n        \n        \n        
F\u00e4ltnamn<\/th>\n        Typ<\/th>\n        Beskrivning och Villkor<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
id<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Ett unikt id f\u00f6r ett detta specifika meddelande.\n        <\/td>\n        \n          
\n\"id\": \"5bcf4324ee47dee41a9dbb13\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
batchId<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Den \u00f6vergripande batchens id\n        <\/td>\n        \n          
\n\"batchId\": \"5bc86b6e85c7209830f96936\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
owner<\/strong><\/td>\n        String<\/code><\/td>\n        \n          SMS-kontots ID, \u00e4gare f\u00f6r det specifika meddelandet.\n        <\/td>\n        \n          
\n\"owner\": \"ip1-XXXXX\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
sender<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Avs\u00e4ndaren f\u00f6r meddelandet\n        <\/td>\n        \n          
\n\"sender\": \"iP1\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
recipient<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Mottagarens mobilnummer\n        <\/td>\n        \n          
\n\"recipient\": \"456189040623\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
body<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Sj\u00e4lva meddelandet\n        <\/td>\n        \n          
\n\"body\": \"Hi my name is earl\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    
direction<\/strong><\/td>\n      String<\/code><\/td>\n      \n        Talar om ifall meddelandet skickades<\/strong> eller togs emot<\/strong> av v\u00e5rt system.\n        
    \n          
  • MT<\/code> En akronym f\u00f6r Mobile Terminated, ett meddelande som skickades till en mobil enhet.<\/li>\n          
  • MO<\/code> En akronym f\u00f6r Mobile Originated, ett meddelande som skickades fr\u00e5n en mobil enhet.<\/li>\n        <\/ul>\n      <\/td>\n      
\n \"direction\": \"MT\"\n      <\/code><\/pre><\/td>\n    <\/tr>\n      
segments<\/strong><\/td>\n        String<\/code><\/td>\n        \n          I de fall meddelandet best\u00e5r av fler tecken \u00e4n teckengr\u00e4nsen f\u00f6r ett SMS kommer meddelandet att delas upp i\n          flera SMS, \u00e4ven kallat konkatenerade SMS. Den h\u00e4r egenskapen indikerar om hur m\u00e5nga SMS som beh\u00f6vs f\u00f6r att\n          kunna skicka meddelandet\n        <\/td>\n        \n          
\n\"segments\": 1\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
datacoding<\/strong><\/td>\n        String<\/code><\/td>\n        \n          Anger det minsta datakodningsschema som beh\u00f6vs f\u00f6r att skicka meddelandet i fr\u00e5ga. Om meddelandetexten\n          inneh\u00e5ller tecken utanf\u00f6r den angivna datakodningen skickas inte meddelandet, vilket den senaste statuskoden\n          ska visa. Detta kan skilja sig fr\u00e5n batchens datakodning.\n        <\/td>\n        \n          
\n\"datacoding\": \"ucs\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
priority<\/strong><\/td>\n        String<\/code><\/td>\n        Meddelandets prioritet. Prioritet 1 \u00e4r standardv\u00e4rdet och samtidigt den l\u00e4gsta prioritet som tillhandah\u00e5lls.\n          Prioritet 2 \u00e4r den h\u00f6gsta prioriteten.<\/td>\n        \n          
\n \"priority\": 1\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
price<\/strong><\/td>\n        String<\/code><\/td>\n        Hela meddelandets pris. Vill du veta priset f\u00f6r ett enskilt SMS i ett meddelande, kan du dela meddelandets\n          pris med antalet segment.<\/td>\n        \n          
\n \"price\": 0.0416\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
currency<\/strong><\/td>\n        String<\/code><\/td>\n        Vilken valuta som meddelandets pris anv\u00e4nder.<\/td>\n        \n          
\n  \"currency\": \"EUR\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
statuses<\/strong><\/td>\n        Array<\/code><\/td>\n        En lista best\u00e5ende av statusuppdateringar. Vid h\u00e4mtning av ett enskilt meddelande s\u00e5 f\u00e5r man en lista av meddelandets samtliga statusar. Vid h\u00e4mtning av lista f\u00f6r flera meddelanden listas enbart varje meddelandes senaste status.<\/td>\n        \n          
\n \"statuses\": [\n    {\n        \"created\": \"2018-10-23T17:43:21Z\",\n        \"code\": 201,\n        \"duration\": 0\n    }\n],\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
modified<\/strong><\/td>\n        String<\/code><\/td>\n        N\u00e4r SMS:et senast uppdaterades<\/td>\n        \n          
\n\"modified\": \"2018-10-23T17:43:19Z\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
reference<\/strong><\/td>\n        String<\/code><\/td>\n        Detta \u00e4r en egenskap som till\u00e5ter anv\u00e4ndaren att s\u00e4tta ett eget ID eller referens om lagring av\n          standard-genererade ID\u00b4n ogillas.<\/td>\n        \n          
\n\"reference\": \"A client reference\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mcc<\/strong><\/td>\n        String<\/code><\/td>\n        Lands-delen av bladoperat\u00f6ren kan specificeras h\u00e4r om den tillhandah\u00e5lls av uppstr\u00f6ms-b\u00e4raren.\n          MCC\u00a0\u00e4r en akronym f\u00f6r Mobile Country Code\n        <\/td>\n        \n          
\n\"mcc\": \"431\",\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
mnc<\/strong><\/td>\n        String<\/code><\/td>\n        N\u00e4tverks-delen av bladoperat\u00f6ren kan specificeras h\u00e4r om den tillhandah\u00e5lls av uppstr\u00f6ms-b\u00e4raren.\n          MNC \u00e4r en akronym f\u00f6r Mobile Network Code\n        <\/td>\n        \n          
\n\"mnc\": \"20\"\n      <\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n<\/div>\n\n\n\n