{"id":451,"date":"2023-11-23T13:46:31","date_gmt":"2023-11-23T12:46:31","guid":{"rendered":"http:\/\/localhost\/wordpress\/?page_id=451"},"modified":"2026-01-09T12:32:55","modified_gmt":"2026-01-09T12:32:55","slug":"contacts-batch","status":"publish","type":"page","link":"https:\/\/ip1sms.com\/en\/developer\/contacts-batch\/","title":{"rendered":"Mass operations"},"content":{"rendered":"\n
\n
\n
\n\n\n\n

Mass-operationer<\/h1>\n\n\n\n

Dessa endpoints utf\u00f6r s\u00e5 kallade mass-operationer och kan ibland vara destruktivt eller ”farligt” d\u00e5 data kan f\u00f6rsvinna om den inte anv\u00e4nds p\u00e5 r\u00e4tt s\u00e4tt.<\/p>\n\n\n\n

Quick start<\/h2>\n\n\n
\ncurl -X DELETE "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
Radera kontakter genom filtrering<\/h3>\n\n\n\n
Endpoint: v2\/contacts<\/p>\n\n\n\n
Metod: DELETE<\/code><\/p>\n\n\n\n
Denna endpoint l\u00e5ter dig ta bort alla kontakter som matchar de anv\u00e4nda filtren. Detta \u00e4r destruktivt och b\u00f6r anv\u00e4ndas med f\u00f6rsiktighet. Den returnerar en samling av de borttagna kontakterna ungef\u00e4r som att lista dem.<\/p>\n\n\n\n
Exempel p\u00e5 anrop<\/h4>\n\n\n\n
Detta anrop raderar samtliga kontakter.<\/p>\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
Detta anrop raderar samtliga blockerade kontakter med etiketten ”Kunder”.<\/p>\n\n\n
\nhttps:\/\/api.ip1sms.com\/v2\/contacts?labels=Kunder&metadata%5BphoneNumber.isBlocked%5D=true\n<\/pre><\/div>\n\n\n
\n\n\n\n
Respons<\/h2>\n\n\n\n
Exempel p\u00e5 respons<\/h3>\n\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": "true"\n      }\n    },\n    "labels": [\n      "Kunder",\n      "all"\n    ]\n  }\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        
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          
[\"Kunder\", \"all\"]<\/code><\/pre>\n        <\/td>\n      <\/tr>\n    <\/tbody>\n  <\/table>\n<\/div>\n\n\n\n
F\u00e4lt f\u00f6r metadata<\/h3>\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<\/div>\n<\/div>\n\n\n\n
\n