API Jojka är utrustat med ett kraftfullt API. Utöka din applikation till att även kommunicera med Jojka. Det är väldigt enkelt att komma igång. Här nedan följer en presentation av alla funktioner. Notera * Alla våra API anrop måste skickas med HTTPS, ej HTTP. * All våra API anrop måste skickas som POST. Använd inte GET! * Parametern msg måste vara i tecken formatet UTF-8. * Parametern API_key måste skickas i alla anrop, detta används för att verifiera dig som kund. Som kund får man sitt unika API_key efter man beställt API-access som tjänst, kontakta oss ang detta. * Alla svar fås i JSON format. * Mobilnummer kan anges i följande 3 format: 46730911988, 0730911988, 730911988 1. Skicka ett SMS till specifikt nummer url: https://www.jojka.nu/websms/api/send from=<din beställda alias, tex företagsnamn> EJ obligatorisk parameter. (OBS för Pro och Enterprise har tillgång valfria alias, behöver ej vara det förbeställda alias) Om inte denna parameter skickas med i anropet, kommer utskicket att gå från ditt Jojka-nummer som avsändare. Om denna parameter skickas med kommer du förbeställda alias användas som avsändare, oavsett vad som står i denna parameter. to=<ett mobilnummer> msg=<meddelandet som skall skickas i SMS:et>
https://www.jojka.nu/websms/api/send?from=nelly&to=46730987654&msg=hej&api_key=12 3 ["message_id":"xxx"] 2. Skicka Ny Kampanj till specifika nummer (inkl schemaläggning) url: https://www.jojka.nu/websms/api/add_campaign from=<din beställda alias, tex företagsnamn> EJ obligatorisk parameter. (OBS för Pro och Enterprise har tillgång valfria alias, behöver ej vara det förbeställda alias) Om inte denna parameter skickas med i anropet, kommer utskicket att gå från ditt Jojka-nummer som avsändare. Om denna parameter skickas med kommer du förbeställda alias användas som avsändare, oavsett vad som står i denna parameter. to_msisdn=<ett eller flera mobilnummer, åtskiljda med semikolon> msg=<meddelandet som skall skickas i SMS:et> scheduled=<tid då kampanjen ska påbörjas skickas> EJ obligatorisk parameter Måste anges i formatet 2012-12-12 23:34:45 name=<kampanjnamn, syns inte för mottagare> EJ obligatorisk parameter Om denna parameter inte skickas med i anropet kommer kampanjen döpas till (Namnlös) https://www.jojka.nu/websms/api/add_campaign?from=nelly&to_msisdn=46730987654;467361 23456&msg=hej&name=Test&API_key=123 ["campaign_id":"xxx"]
3. Skicka Ny Kampanj till förvald grupp (inkl schemaläggning) url:https://www.jojka.nu/websms/api/add_campaign from=<din beställda alias, tex företagsnamn> EJ obligatorisk parameter. Om inte denna parameter skickas med i anropet, kommer utskicket att gå från ditt Jojka-nummer som avsändare. Om denna parameter skickas med kommer du förbeställda alias användas som avsändare, oavsett vad som står i denna parameter. to_group=<ett eller flera gruppnamn åtskiljda med semikolon> Ange gruppen all för att skicka utskicket till alla dina kontakter msg=<meddelandet som skall skickas i SMS:et> scheduled=<tid då kampanjen ska påbörjas skickas> EJ obligatorisk parameter Måste anges i formatet 2012-12-12 23:34:45 name=<kampanjnamn, syns inte för mottagare> EJ obligatorisk parameter Om denna parameter inte skickas med i anropet kommer kampanjen döpas till (Namnlös) https://www.jojka.nu/websms/api/add_campaign?from=nelly&to_group=all&msg=hej&name= Test&API_key=123 ["campaign_id":"xxx"] 4. Lägga till ny kontakt (inkl till förvald grupp)
url: https://www.jojka.nu/websms/api/add_contact msisdn=<den nya kontaktens mobilnummer> name=<för och efternamn på den nya kontakten> group=<en eller flera grupper den nya kontakten skall vara med i, åtskiljda av semikolon> Ej obligatorisk parameter Om ett gruppnamn anges som inte finns på ditt Jojka konto, så skapas ett ny grupp med det angivna namnet. https://www.jojka.nu/websms/api/add_contact?name=dennis&msisdn=46730123456&group=gr upp1&api_key=123 ["msisdn":"xxx"] 5. Lägga till existerande kontakt till förvald gruppurl: https://www.jojka.nu/websms/api/add_contact_to_group POST parametrar:msisdn=<den existerande kontaktens mobilnummer> group=<namn på gruppen som den existerande kontakten skall vara med i> Om ett gruppnamn anges som inte finns på ditt Jojka konto, så skapas ett ny grupp med det angivna namnet. API_key=<ditt unika API nyckel> https://www.jojka.nu/websms/api/add_contact_to_group?msisdn=46730123456&group=grupp1 &API_key=123 ["msisdn":"xxx", "group": "yyy"]
6. Ta bort kontakt från förvald gruppurl: https://www.jojka.nu/websms/api/rm_contact_from_group POST parametrar:msisdn=<den existerande kontaktens mobilnummer> group=<namn på gruppen som den existerande kontakten skall tas bort från> API_key=<ditt unika API nyckel> https://www.jojka.nu/websms/api/rm_contact_from_group?msisdn=46730123456&group=grup p1&api_key=123 ["msisdn":"xxx", "group": "yyy"] 7. Hämta alla meddelande id för given kampanjurl: https://www.jojka.nu/websms/api/get_msg_ids_by_campaign_id POST parametrar:campaign_id=<unika id et för tidigare skickad kampanj> API_key=<ditt unika API nyckel> https://www.jojka.nu/websms/api/get_msg_ids_by_campaign_id?campaign_id=567864&api_k ey=123 ["x", "y", "z"] 8. Hämta leveransstatus för given meddelande idurl: https://www.jojka.nu/websms/api/get_msg_status msg_id=<unika id et för tidigare skickat meddelande> https://www.jojka.nu/websms/api/get_msg_status?msg_id=567864&api_key=123
["STATUS"] 9. Hämta SMS svar url: https://www.jojka.nu/websms/api/fetch_replies from_msisdn=<filtrera svar på enskilt mobilnummer> Ej obligatorisk parameter Om detta fält inte skickas med så får man alla svar, oavsett vilket mobilnummer som skickat svaret. since_time=<nya SMS svar sedan följande dataum> Ej obligatorisk parameter Om detta fält inte skickas med så hämtas alla svar sedan de senaste 4 dagarna. https://www.jojka.nu/websms/api/fetch_replies?since_time=2012-03- 12&from_msisdn=46733370861&API_key=123 [{ inserted : 2012-11-14 11:54:42, sender : 467082xxxx, message : Stop },{ inserted : 2012-11-12 17:30:28, sender : 467097xxxx, message : Test :) }] 10. Hämta message_id, mottagare och status med campaign_id url: https://www.jojka.nu/websms/api/get_campaign_recipients_status campaign_id=<kampanj id som man har fått när man har skickat iväg en kampanj>
https://www.jojka.nu/websms/api/get_campaign_recipients_status?campaign_id=1&api_key=1 23 [{ receiver : 467352xxxxx, message_id : 1900607, status : DELIVERED }, { receiver : 4670903xxxxxx, message_id : 1925062, status : ERROR }, { receiver : 4670903xxxxxx, message_id : 1925062, status : SENDING_OK }] 11. Importera en hel kontakt lista (inkl till förvald grupper) url: https://www.jojka.nu/websms/api/import_contacts_list contacts_list =<Posta in kontakt listan> contacts_list_url =<Url för en fil/ström> Man kan välja mellan ströma in en kontakt lista via en url länk med https/http/ftp eller posta in hela listan listan formant måste vara i UTF8. Format på listan kan vara mixat och fungera 100% med CSV format Textavgränsare : finns ingen tecken för det. Fältavgränsare: ett av följande tecken, eller ; Ny post : \n Exempel på mixad kontakt lista namn,telefon\n NAMN;TELEFON;GROUP1\N NAMN;TELEFON,GROUP1;GROUP2\N Svars : { SUCCESSES : DONE } { ERROR :[ TYP AV FEL ]} 12. Export kontakt listan med grupper url: https://www.jojka.nu/websms/api/export_contacts_list
max=<max antal kontakter per gång, max värdet är 10000, om detta värde är ej satt så är max 100 per gång> offset =<position i din kontakt lista> Exempel på export av kontakt lista Svars : { EXPORT :[{ MSISDN : 4673XXXXX1, NAME : GUSTAV LUNDBERG, INSERTED : 2013-03-12 15:22:58, GROUPS :[ GRUPP1, GRUPP2 ]},{ MSISDN : 4673XXXXX2, NAME : NICKLAS LARSON, INSERTED : 2013-03-12 15:22:58, GROUPS :[]}]}