{"id":452,"date":"2023-11-23T13:46:31","date_gmt":"2023-11-23T12:46:31","guid":{"rendered":"http:\/\/localhost\/wordpress\/?page_id=452"},"modified":"2026-01-14T07:15:56","modified_gmt":"2026-01-14T07:15:56","slug":"contacts","status":"publish","type":"page","link":"https:\/\/ip1sms.com\/en\/developer\/contacts\/","title":{"rendered":"Managing Contacts"},"content":{"rendered":"\n
\n
\n
\n\n\n\n

Hantera kontakter<\/h1>\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.<\/p>\n\n\n

\ncurl -X GET "https:\/\/api.ip1sms.com\/v2\/contacts\/" \\\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
L\u00e4s en samling av kontakter<\/h3>\n\n\n\n
Endpoint: contacts<\/p>\n\n\n\n
Metod: GET<\/code><\/p>\n\n\n\n
Denna endpoint ger dig en samling kontakter f\u00f6r vilka du kan se definitionen av kontaktdokumentet nedan. <\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts\n<\/pre><\/div>\n\n\n
Exempel p\u00e5 anrop med filter<\/h4>\n\n\n\n
Denna samling kan \u00e4ven filtreras efter egenskaper, metadata och\/eller etiketter med hj\u00e4lp av fr\u00e5geparametrar. Metadata finns bara om meta l\u00e4ggs till som en query-parameter.<\/p>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts?labels=Coworker&properties%5BphoneNumber%5D=%2B46123456789&metadata%5BphoneNumber.isBlocked%5D=false\n<\/pre><\/div>\n\n\n
L\u00e4s en enskild kontakt<\/h3>\n\n\n\n
Denna endpoint ger dig en enda specifik kontakt. Metadata finns bara om ”meta” l\u00e4ggs till som en query parameter<\/p>\n\n\n\n
Endpoint: contacts\/{contactId}<\/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\/v2\/contacts\/606312a5d233ab8484e18404\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anropsdata<\/h4>\n\n\n\n
\n\n  \n    \n      \n    \n      
F\u00e4ltnamn<\/th>\n      Typ<\/th>\n      Beskrivning<\/th>\n      Exempel<\/th>\n    <\/tr>\n  <\/thead>\n  
contactId<\/strong><\/td>\n      String<\/code><\/td>\n      \n        Kontaktens ID.\n      <\/td>\n      
\n606312a5d233ab8484e18404\n      <\/code><\/pre><\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n\n\n
Uppdatera en kontakt<\/h3>\n\n\n\n
Endpoint: contacts\/{contactId}<\/p>\n\n\n\n
Metod 1: PATCH<\/code><\/p>\n\n\n\n
Metod 2: PUT<\/code><\/p>\n\n\n\n
Med dessa endpoints kan du uppdatera en kontakt och \u00e4ndra lagrad data. Genom att anv\u00e4nda HTTP-verbet PATCH<\/code> g\u00f6r du en delvis uppdatering, anger eventuella v\u00e4rden som finns och tar bort alla tydliga null-v\u00e4rden om null-v\u00e4rden existerar. Om du anv\u00e4nder PUT<\/code> ers\u00e4tts all existerande data med nya data oavsett tidigare v\u00e4rden.<\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts\/606312a5d233ab8484e18404\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anrop<\/h4>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        
F\u00e4ltnamn<\/th>\n        Obligatoriskt<\/th>\n        Typ<\/th>\n        Beskrivning<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
id<\/strong><\/td>\n        Ja<\/td>\n        String<\/code><\/td>\n         Kontaktens unika ID.<\/td>\n        \n          
606312a5d233ab8484e18404<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
properties<\/strong><\/td>\n        Ja<\/strong><\/td>\n        Object<\/code><\/td>\n         Inneh\u00e5ller kontaktens faktiska information. H\u00e4r definieras f\u00e4lt som phoneNumber<\/code>,\n          firstName<\/code> och email<\/code>. <\/td>\n        \n          
{ \"phoneNumber\": \"46123456789\", \"firstName\": \"Bertilsson\" }<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
labels<\/strong><\/td>\n        Nej<\/td>\n        Array<\/code><\/td>\n         En lista av str\u00e4ngar som anv\u00e4nds f\u00f6r att gruppera eller kategorisera kontakten. <\/td>\n        \n          
[\"Coworker\", \"Sales\"]<\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
L\u00e4gg till\/importera kontakter<\/h3>\n\n\n\n
Endpoint: contacts<\/p>\n\n\n\n
Metod: POST<\/code><\/p>\n\n\n\n
Denna endpoint l\u00e5ter dig l\u00e4gga till\/importera nya kontakter. Den tar en samling kontaktdokument. Som standard accepteras kontakterna och importeras sedan i bakgrunden, men det kan g\u00f6ras direkt genom att l\u00e4gga till sync som en fr\u00e5geparameter. Direktimport rekommenderas endast f\u00f6r sm\u00e5 samlingar av kontakter (f\u00e4rre \u00e4n 1000).<\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anrop<\/h4>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        
F\u00e4ltnamn<\/th>\n        Obligatoriskt<\/th>\n        Typ<\/th>\n        Beskrivning<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
properties<\/strong><\/td>\n        Ja<\/strong><\/td>\n        Object<\/code><\/td>\n         Inneh\u00e5ller kontaktens faktiska information. H\u00e4r definieras f\u00e4lt som phoneNumber<\/code>,\n          firstName<\/code> och email<\/code>. <\/td>\n        \n          
{ \"phoneNumber\": \"46123456789\", \"firstName\": \"Icarus\" }<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
labels<\/strong><\/td>\n        Nej<\/td>\n        Array<\/code><\/td>\n         En lista av str\u00e4ngar som anv\u00e4nds f\u00f6r att gruppera eller kategorisera kontakten. <\/td>\n        \n          
[\"Coworker\", \"Sales\"]<\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
Radera kontakter<\/h3>\n\n\n\n
Endpoint: DELETE contacts\/{contactId}<\/code><\/p>\n\n\n\n
Denna endpoint l\u00e5ter dig ta bort en kontakt. Det finns ocks\u00e5 en endpoint f\u00f6r att ta bort mer \u00e4n en kontakt, se avsnittet f\u00f6r Massoperationer<\/a>.<\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts\/606312a5d233ab8484e18404\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r anrop<\/h4>\n\n\n\n
\n\n  \n    \n      \n    \n      
F\u00e4ltnamn<\/th>\n      Typ<\/th>\n      Beskrivning<\/th>\n      Exempel<\/th>\n    <\/tr>\n  <\/thead>\n  
contactId<\/strong><\/td>\n      String<\/code><\/td>\n      \n        Kontaktens ID.\n      <\/td>\n      
\n606312a5d233ab8484e18404\n      <\/code><\/pre><\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n\n\n
\n\n\n\n
Responsdata-typ<\/h2>\n\n\n
\n{\n  "id": "606312a5d233ab8484e18404",\n  "ownerId": "ip1-XXXXX",\n  "properties": {\n    "phoneNumber": "46123456789",\n    "email": "icarus@example.com",\n    "firstName": "Icarus",\n    "lastName": "Sol",\n    "department": "Sales"\n  },\n  "metadata": {\n    "phoneNumber": {\n      "isPossiblePhoneNumber": "true",\n      "isValidPhoneNumber": "true",\n      "phoneNumberType": "MOBILE",\n      "parsedMSISDN": "46123456789",\n      "isBlocked": "false"\n    }\n  },\n  "labels": [\n    "Coworker",\n    "all"\n  ]\n}\n<\/pre><\/div>\n\n\n
F\u00e4lt f\u00f6r responsdata<\/h4>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        \n        \n        
F\u00e4ltnamn<\/th>\n        Typ<\/th>\n        Beskrivning<\/th>\n        Exempel<\/th>\n      <\/tr>\n    <\/thead>\n    
id<\/strong><\/td>\n        String<\/code><\/td>\n         Kontaktens unika ID i systemet. Anv\u00e4nds f\u00f6r referens vid framtida anrop (GET, PATCH, DELETE). <\/td>\n        \n          
606312a5d233ab8484e18404<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
ownerId<\/strong><\/td>\n        String<\/code><\/td>\n         ID f\u00f6r det konto (systemanv\u00e4ndare) som \u00e4ger och har beh\u00f6righet till kontakten. <\/td>\n        \n          
ip1-XXXXX<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
properties<\/strong><\/td>\n        Object<\/code><\/td>\n         En samling av kontaktens r\u00e5data s\u00e5som telefonnummer, namn och avdelning. Inneh\u00e5ller de f\u00e4lt som definierats\n          vid skapande\/uppdatering. <\/td>\n        \n          
{ \"phoneNumber\": \"46123456789\", \"firstName\": \"Icarus\" }<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
metadata<\/strong><\/td>\n        Object<\/code><\/td>\n         Systemgenererad information som validerar och berikar kontaktens egenskaper. Inkluderas endast om\n          query-parametern ?meta<\/code> anv\u00e4nds. <\/td>\n        \n          
{ \"phoneNumber\": { \"isValidPhoneNumber\": \"true\", \"parsedMSISDN\": \"46123456789\" } }<\/code><\/pre>\n        <\/td>\n      <\/tr>\n      
labels<\/strong><\/td>\n        Array<\/code><\/td>\n         En lista av str\u00e4ngar som representerar de etiketter kontakten \u00e4r grupperad under. <\/td>\n        \n          
[\"Coworker\", \"all\"]<\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
F\u00e4lt f\u00f6r metadata<\/h4>\n\n\n\n
\n  \n    \n      \n        \n      \n        \n        \n        \n        \n        
Egenskap (Metadata)<\/th>\n        Typ<\/th>\n        Beskrivning<\/th>\n      <\/tr>\n    <\/thead>\n    
isPossiblePhoneNumber<\/strong><\/td>\n        String<\/code> (Boolean)<\/td>\n        Indikerar om numret ser korrekt ut strukturellt.<\/td>\n      <\/tr>\n      
isValidPhoneNumber<\/strong><\/td>\n        String<\/code> (Boolean)<\/td>\n        Bekr\u00e4ftar om numret \u00e4r ett faktiskt existerande format f\u00f6r det aktuella landet.<\/td>\n      <\/tr>\n      
phoneNumberType<\/strong><\/td>\n        String<\/code><\/td>\n        Beskriver typen av abonnemang, t.ex. MOBILE<\/code>, FIXED_LINE<\/code> eller VOIP<\/code>.\n        <\/td>\n      <\/tr>\n      
parsedMSISDN<\/strong><\/td>\n        String<\/code><\/td>\n        Numret formaterat som MSISDN (utan prefix), vilket \u00e4r det format systemet anv\u00e4nder f\u00f6r utskick.<\/td>\n      <\/tr>\n      
isBlocked<\/strong><\/td>\n        String<\/code> (Boolean)<\/td>\n        Visar om kontakten finns med p\u00e5 kontots blacklist\/sp\u00e4rrlista.<\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
\n\n\n\n
Kodexempel<\/h2>\n\n\n\n
Nedan hittar du ett enkelt kodexempel med autentisering och funktionalitet f\u00f6r att l\u00e4gga till en kontakt.<\/p>\n\n\n\n
L\u00e4gg till en kontakt i C#<\/h4>\n\n\n
\nusing System;\nusing System.Collections.Generic;\nusing System.Net.Http;\nusing System.Net.Http.Headers;\nusing System.Net.Http.Json; \nusing System.Threading.Tasks;\n\nusing (var client = new HttpClient())\n{\n    client.BaseAddress = new Uri("https:\/\/api.ip1sms.com\/v2\/");\n    client.DefaultRequestHeaders.Accept.Clear();\n    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application\/json"));\n    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "DIN_API_NYCKEL");\n\n    \/\/ Skapa en enskild kontakt\n    var contact = new Contact()\n    {\n        properties = new Dictionary<string, string>() {\n            { "phoneNumber", "46123456789"},\n            { "email", "icarus@example.com" },\n            { "firstName", "Icarus" },\n            { "lastName", "Sol" },\n            { "department", "Sales" }\n        },\n        labels = new List<string>() { "Coworker", "Sales" }\n    };\n\n    var contactList = new List<Contact> { contact };\n\n    HttpResponseMessage response = await client.PostAsJsonAsync("contacts", contactList);\n\n    if (response.IsSuccessStatusCode)\n    {\n        Console.WriteLine("Success: Contact(s) accepted for import.");\n    }\n    else\n    {\n        string errorDetails = await response.Content.ReadAsStringAsync();\n        Console.WriteLine($"Failed, {response.StatusCode}: {errorDetails}");\n    }\n}\n\npublic class Contact\n{\n    public Dictionary<string, string> properties { get; set; }\n    public List<string> labels { get; set; }\n}\n<\/pre><\/div>\n\n\n<\/div>\n<\/div>\n\n\n\n
\n