SMS & Viber API Documentation

Γενικά

Το easysms.gr είναι συνεχώς αναπτυσσόμενη υπηρεσία αποστολής μηνυμάτων.

Με το εκτεταμένο σύνολο εντολών (SMS API) μπορείτε να ολοκληρώσετε τις αποστολές μηνυμάτων και όλη τη διαχείριση των επαφών, ομάδων και καμπάνιων σας μέσα από τις δικές σας εφαρμογές και ERP συστήματα.
Η σχεδίασή του είναι απλή αλλά με πολλές δυνατότητες.

Για τις αποστολές σας χρησιμοποιείτε ως αποστολέα το όνομα της επιχείρισής σας και θα λάβετε αναφορά παράδοσης για κάθε μήνυμα ξεχωριστά μέσα σε λίγα δευτερόλεπτα από την αποστολή.

Για να ξεκινήσετε να χρησιμοποιείτε την υπηρεσία θα χρειαστεί να δημιουργήσετε ένα δωρεάν λογαριασμό. Θα είναι έτοιμος αμέσως και θα πιστωθεί με 5 μηνύματα για να δοκιμάσετε την ποιότητα της υπηρεσίας.

Η χρήση του IP Whitelist συνίσταται για την προστασία του λογαριασμού και των δεδομένων του. Όλοι οι λογαριασμοί έχουν ενεργοποιημένη την IP Whitelist και για την χρήση του API χρειάζεται να προστεθεί η διεύθυνση IP στην λίστα αυτή. Εναλλακτικά μπορείτε να απενεργοποιήσετε την προστασία αυτή από τις Ρυθμίσεις Ασφάλειας του λογαριασμού σας. Όταν είναι ενεργοποιημένη το API επιτρέπει κλήσεις μόνο απο τις συγκεκριμένες IP διευθύνσεις. Σε κάθε άλλη περίπτωση επιστρέφει σφάλμα λάθους στοιχείων σύνδεσης.

Γίνεται με την χρήση του API key του κάθε λογαριασμού. Μοναδική εξαίρεση η κλήση για τον έλεγχο εγκυρότητας τηλεφώνου api/mobile/check που είναι ελεύθερη για όλους. Το κλειδί μπορεί να ανανεωθεί με την κλήση api/key/reset για αυξημένη ασφάλεια.

Επίδειξη & δοκιμή SMS API

Δείτε την επίδειξη του SMS API ως "demo" χρήστης
ή εισάγετε το email και τον κωδικό σας

Όνομα χρήστη

Κωδικός πρόσβασης

REST SMS API

Αυτή είναι η 3^η έκδοση του SMS API και είναι υπερσύνολο των προηγούμενων εκδόσεων, οπότε είναι συμβατή τόσο με την 2^η έκδοση όσο και με την v.1

Όλες οι κλήσεις του API μπορούν να γίνονται μέσω https ή http
Οι παράμετροι μπορούν να στέλνονται με τις μεθόδους GET ή POST
Χρησιμοποιείται κωδικοποίση UTF-8 για όλες τις κλήσεις
Οι αριθμοί κινητών τηλεφώνων μορφοποιούνται και αποθηκεύονται σε MSISDN μορφή

api/mobile

Ο έλεγχος αριθμού κινητού τηλεφώνου api/mobile/check είναι η μόνη κλήση που δεν απαιτεί αυθεντικοποίηση με κλειδί λογαριασμού key. Είναι ελεύθερη για χρήση από όλους, πολύ αποτελεσματική και γρήγορη. Μπορεί να ελέγξει δεκάδες χιλιάδες τηλέφωνα σε λιγότερο από 1 δευτερόλεπτο

api/mobile/check

Ελέγχει για εγκυρότητα αριθμών κινητών τηλεφώνων στην παράμετρο mobile και επιστρέφει τα αποτελέσματα ή σφάλμα

Για δοκιμή γράψτε το κινητό σας παρακάτω και πατήστε "έλεγχος" για να πάρετε μια γεύση από το API

https://easysms.gr/api/mobile/check

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`mobile`	Κινητό	Οποιοδήποτε αλφαριθμητικό για έλεγχο. Σημειώστε οτι θα αφαιρεθούν όλοι οι μη αριθμητικοί χαρακτήρες. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`mobile{` `msisdn` `national` `country` `countryCode` `gsmCode` `number` `mcc` `mnc` `cost` `}`	Αντικείμενο κινητό Αριθμός κινητού (MSISDN) Αριθμός κινητού (εθνική μορφή) Πρόθεμα χώρας Πρόθεμα δικτύου Αριθμός Κωδικός χώρας Κωδικός δικτύου Κόστος μηνύματος
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`201`	Η παράμετρος `mobile` δεν αντιστοιχίζεται σε MSISDN (διεθνή μορφή αριθμών κινητών τηλεφώνων)Αναπαραγωγή
`205`	Η παράμετρος `mobile` είναι κενή Αναπαραγωγή

<?php

  $endpoint = 'https:///mobile/check';

  $parameters = array(
      'mobile'    => '306971234567',// mobile to check

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///mobile/check?\
mobile=4412345678900"

api/key

Κλήσεις get και reset για ανάκτηση και ανανέωση του API key

api/key/get

Επιστρέφει το API key του λογαριασμού
Απαιτείται IP Whitelist

https://easysms.gr/api/key/get

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`username`	Όνομα χρήστη	Το username ή το email ή το κινητό του λογαριασμού. [Απαιτείται] To API key [key=YOUR-API-KEY] μπορεί να αντικαταστήσει το [username-password] αν χρειάζεται να επιβεβαιώσετε το κλειδί
`password`	Κωδικός	Κωδικός πρόσβασης λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`key`	To API κλειδί του λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///key/get';

  $parameters = array(
      'username'  => 'YOUR USERNAME',
      'password'  => 'YOUR PASSWORD',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///key/get?\
username=USERNAME&\
password=PASSWORD&\
type=xml"

api/key/reset

Ανανεώνει το κλειδί API του λογαριασμού σε νέο μοναδικό και τυχαίο κλειδί. Μπορεί να χρησιμοποιείται συχνά για αυξημένη ασφάλεια
Απαιτείται IP Whitelist

https://easysms.gr/api/key/reset

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`username`	Όνομα χρήστη	Username ή email ή κινητό του λογαριασμού. [Απαιτείται] Το API key [key=YOUR-API-KEY] μπορεί να χρησιμοποιηθεί αντί του [username-password]
`password`	Κωδικός	Κωδικός πρόσβασης λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`key`	To API κλειδί του λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///key/reset';

  $parameters = array(
      'username'  => 'YOUR USERNAME',
      'password'  => 'YOUR PASSWORD',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///key/reset?\
username=USERNAME&\
password=PASSWORD&\
type=xml"

api/sms

Οι πιο δημοφιλείς κλήσεις με διαφορά

αποστολή απλού μηνύματος
αποστολή ομαδικού μηνύματος
προγραμματισμός αποστολής στο μέλλον
ακύρωση προγραμματισμένης αποστολής

api/sms/bulk

Αποστολή ομαδικού μηνύματος
Απαιτείται IP Whitelist

https://easysms.gr/api/sms/bulk

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`to`	Κινητά διαχωρισμένα με ,	Αριθμοί κινητών παραληπτών διαχωρισμένοι με κόμμα , [Απαιτείται]
`text`	Κείμενο	Το κείμενο του μηνύματος. [Απαιτείται]
`from`	Αποστολέας	Αποστολέας του μηνύματος
`ucs`	Unicode	`true` για Unicode ή `false` για GSM κωδικοποίηση (προκαθορισμένη)
`flash`	Flash	`true` για flash sms ή `false` για κανονικό (προκαθορισμένο)
`timestamp`	Χρόνος αποστολής	Χρόνος αποστολής εκφρασμένος σε Unix epoch timestamp. Προγραμματισμένα μηνύματα μπορούν να ακυρωθούν με την εντολή `api/sms/cancel`
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`id{` `value` `...` `}` `sms{` `smsId` `msisdn` `}` `...`	Πίνακες με id και sms αντικείμενα
`accepted`	Σύνολο μηνυμάτων που έγιναν δεκτά
`rejected`	Σύνολο απορριφθέντων μηνυμάτων
`balance`	Υπόλοιπο λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`102`	Η παράμετρος `to` είναι κενή
`103`	Μη έγκυρη παράμετρος `to`. Η κλήση `api/mobile/check` θα ελέγξει τάχιστα οποιοδήποτε κινητό για εγκυρότητα
`104`	Η παράμετρος `text` είναι κενή
`105`	Ο λογαριασμός δεν έχει αρκετό υπόλοιπο για την αποστολή

<?php

  $endpoint = 'https:///sms/bulk';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your message',
      'from'    => 'sender',
      'to'    => '306971000000,306980000000,49172000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///sms/bulk?\
key=YOUR-API-KEY&\
text=your_message&\
from=sender&\
to=306971000000,306980000000,49172000000&\
type=xml"

api/sms/cancel

Ακυρώνει ένα προγραμματισμένο για αποστολή στο μέλλον μήνυμα. Μπορείτε να προγραμματίσετε μηνύματα για αποστολή με την εντολή api/sms/send ή παρόμοια και την παράμετρο timestamp
Απαιτείται IP Whitelist

https://easysms.gr/api/sms/cancel

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`smsId`	smsId	To `smsId` του μηνύματος που θέλετε να ακυρώσετε. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`smsId`	Διεγραμμένο `smsId`
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`107`	Η παράμετρος `smsId` είναι κενή
`108`	Μη έγκυρη παράμετρος `smsId`
`109`	Δεν βρέθηκε το μήνυμα
`110`	Το μήνυμα έχει ήδη σταλεί
`111`	Το μήνυμα δεν μπόρεσε να διαγραφεί

<?php

  $endpoint = 'https:///sms/cancel';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'smsId'   => 'SMS ID',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///sms/cancel?\
key=YOUR-API-KEY&\
smsId=SMSID&\
type=xml"

api/sms/send

Η πιο δημοφιλής κλήση. Στέλνει ή προγραμματίζει την αποστολή ενός υψηλής προτεραιότητας μηνύματος
Απαιτείται IP Whitelist

https://easysms.gr/api/sms/send

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`to`	Κινητό	Αριθμός κινητού παραλήπτη. [Απαιτείται]
`text`	Text	Το κείμενο του μηνύματος
`from`	From	Αποστολέας του μηνύματος
`ucs`	Unicode	`true` για Unicode ή `false` για GSM κωδικοποίηση (προκαθορισμένη)
`flash`	Flash	`true` για flash sms ή `false` για κανονικό (προκαθορισμένο)
`timestamp`	Timestamp	Χρόνος αποστολής εκφρασμένος σε Unix epoch timestamp. Προγραμματισμένα μηνύματα μπορούν να ακυρωθούν με την εντολή `api/sms/cancel`
`callback`	URL	Callback URL που θα κληθεί για τις αναφορές παράδοσης σε πραγματικό χρόνο. πχ. `http://myserver.com/callback?id=yourmsgid` Στο URL θα προστεθούν οι GET παράμετροι `msgid, status, cost, to, mcc, mnc` που αντιπροσωπεύουν αντίστοιχα: το id του μηνύματος, την κατάσταση (d ή f) για παραδόθηκε ή απέτυχε, το κόστος, τον αριθμό κινητού και πληροφροίες δικτύου. Η χρήση του callback URL έχει πολύ καλύτερη απόδοση και συνίσταται έναντι του polling για status μηνυμάτων από τα endpoints `api/status` Το URL πρέπει να είναι urlencoded()
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`smsId`	`smsId` του μηνύματος
`cost`	Κόστος της αποστολής σε SMS
`balance`	Υπόλοιπο του λογαριασμού
`mcc`	Κωδικός χώρας
`mnc`	Κωδικός δικτύου
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`102`	Η παράμετρος `to` είναι κενή
`103`	Μη έγκυρη παράμετρος `to`. Η κλήση `api/mobile/check` θα ελέγξει οτιδήποτε για έγκυρο κινητό
`104`	Η παράμετρος `text` είναι κενή
`105`	Ο λογαριασμός δεν έχει αρκετό υπόλοιπο για την αποστολή
`106`	Το μήνυμα δεν μπόρεσε να μπεί στην ουρά αποστολής

<?php

  $endpoint = 'https:///sms/send';
  $backupendpoint = 'https:///sms/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your message',
      'from'    => 'sender',
      'to'      => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $backupendpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      curl_setopt($c, CURLOPT_CONNECTTIMEOUT_MS, 1000);
      // try to connect for 1000 ms
      $output =  curl_exec($c);

      if ($output === false ){
        // failed to connect, use backup server
        curl_setopt($c, CURLOPT_URL, $backupendpoint);
        $output =  curl_exec($c);
      }

      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $backupendpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $backupendpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $backupendpoint, $parameters);

curl "https:///sms/send?\
key=YOUR-API-KEY&\
text=your_message&\
from=sender&\
to=306971000000&\
type=xml"

api/viber

Κλήσεις send και balance για αποστολή Viber μηνύματος και ανάκτηση του υπολοίπου

api/viber/send

Αποστολή Viber μηνύματος με επιλογή fall-back σε sms (αν αποτύχει το Viber μήνυμα)
Απαιτείται IP Whitelist

https://easysms.gr/api/viber/send

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`to`	Κινητό	Αριθμός κινητού παραλήπτη. [Απαιτείται]
`text`	Text	Το κείμενο του μηνύματος
`from`	From	Αποστολέας του μηνύματος. Ο αποστολέας πρέπει να εγκριθεί από το Viber.
`button_caption`	Button Caption	Η επιγραφή του κουμπιού
`button_action`	Button Action	Η διεύθυνση ανακατεύθυνσης του κουμπιού
`image`	Image URL	Η διεύθυνση της εικόνας. Πρέπει να είναι διαστάσεων 350px x 350px.
`validity`	Validity seconds	Σε δευτερόλεπτα (από 60 για 1 λεπτό ώς 86400 για 24 ώρες) η περίοδος εγκυρότητας του Viber μηνύματος. Μετά το πέρας γίνεται αποστολή του fall-back SMS. Προκαθορισμένη τιμή είναι 86400 για 24 ώρες
`all_devices`	All	`true` για αποστολή σε Smartphones και Tablets και `false` για αποστολή σε Smartphones μόνο
`sms_fallback`	SMS Fallback	`true` για αποστολή Fallback SMS αν αποτύχει το Viber μήνυμα
`sms_text`	SMS Text	Το κείμενο του fall-back μηνύματος
`sms_from`	Text	Ο αποστολέας του fall-back μηνύματος
`ucs`	Unicode	Για το fall-back SMS: `true` για Unicode ή `false` για GSM κωδικοποίηση (προκαθορισμένη)
`flash`	Flash	Για το fall-back SMS: `true` για flash viber ή `false` για κανονικό (προκαθορισμένο)
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`id`	Το id του μηνύματος Viber
`cost`	To κόστος του μηνύματος Viber
`balance`	To υπόλοιπο του λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`501`	Απουσιάζουν οι παράμετροι `to`, `contactId` ή `groupId`
`503`	Η παράμετρος `from` δεν έχει εγκριθεί. Μπορείτε να κάνεται αίτηση για την έγκριση αποστολέα απο το Viber
`504`	Ο αποστολέας βρίσκεται σε παύση χρήσης. Επικοινωνήστε μαζί μας ώστε να ενεργοποιηθεί και πάλι.
`505`	Δεν εισάγατε το κείμενο του Viber μηνύματος. Το κουμπί πρέπει να συνοδεύει κείμενο
`506`	Το κείμενο του Viber μηνύματος δεν μπορεί να είναι πάνω απο 1000 χαρακτήρες
`507`	Απουσιάζει η επιγραφή του κουμπιού `button_caption`
`508`	Απουσιάζει η παράμετρος `button_action`
`509`	Απουσιάζει η παράμετρος `image`
`510`	Μη έγκυρη παράμετρος `all_devices`
`511`	Μηνύματα με εικόνα και κείμενο πρέπει να περιέχουν και κουμπί
`512`	Μηνύματα χωρίς κείμενο μπορούν να έχουν μόνο εικόνα
`513`	Μη έγκυρη παράμετρος `validity`. Έγκυρες τιμές είναι από 30 (λεπτά) ως 1440 (λεπτά = 24 ώρες)
`514`	Μη έγκυρος αποστολέας `sms_from` του fall-back sms.
`515`	Μη έγκυρη παράμετρος `contactId`
`516`	Μη έγκυρη παράμετρος `groupId`
`517`	Ανεπαρκές υπόλοιπο λογαριασμού
`518`	Το μήνυμα απέτυχε να σταλεί

<?php

  $endpoint = 'https:///viber/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your Viber message',
      'from'    => 'sender',
      'to'      => '306971000000',
      'button_caption' => 'BUTTON',
      'button_action'  => 'YOUR-URL',
      'image'          => 'IMAGE-URL',
      'validity'       => '600',
      'sms_fallback'   => true,
      'sms_from'       => 'ORIGINATOR',
      'sms_text'       => 'Your sms message',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/send?\
key=YOUR-API-KEY&\
text=your_viber_message&\
from=sender&\
to=306971000000&\
button_caption=BUTTON&\
button_action=YOUR-URL&\
image=IMAGE-URL&\
validity=600&\
sms_fallback=true&\
sms_from=ORIGINATOR&\
sms_text=your_sms_message&\
type=xml"

api/viber/bulk

Αποστολή Viber μηνυμάτων σε πολλαπλούς προορισμούς με επιλογή fall-back σε sms (αν αποτύχει το Viber μήνυμα)
Απαιτείται IP Whitelist

https://easysms.gr/api/viber/bulk

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`to`	Κινητά διαχωρισμένα με ,	Αριθμοί κινητών παραληπτών διαχωρισμένα με κόμμα , [Απαιτείται]
`text`	Text	Το κείμενο του μηνύματος
`from`	From	Αποστολέας του μηνύματος. Ο αποστολέας πρέπει να εγκριθεί από το Viber.
`button_caption`	Button Caption	Η επιγραφή του κουμπιού
`button_action`	Button Action	Η διεύθυνση ανακατεύθυνσης του κουμπιού
`image`	Image URL	Η διεύθυνση της εικόνας. Πρέπει να είναι διαστάσεων 350px x 350px.
`validity`	Validity seconds	Σε δευτερόλεπτα (από 60 για 1 λεπτό ώς 86400 για 24 ώρες) η περίοδος εγκυρότητας του Viber μηνύματος. Μετά το πέρας γίνεται αποστολή του fall-back SMS. Προκαθορισμένη τιμή είναι 86400 για 24 ώρες
`all_devices`	All	`true` για αποστολή σε Smartphones και Tablets και `false` για αποστολή σε Smartphones μόνο
`sms_fallback`	SMS Fallback	`true` για αποστολή Fallback SMS αν αποτύχει το Viber μήνυμα
`sms_text`	SMS Text	Το κείμενο του fall-back μηνύματος
`sms_from`	Text	Ο αποστολέας του fall-back μηνύματος
`ucs`	Unicode	Για το fall-back SMS: `true` για Unicode ή `false` για GSM κωδικοποίηση (προκαθορισμένη)
`flash`	Flash	Για το fall-back SMS: `true` για flash viber ή `false` για κανονικό (προκαθορισμένο)
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`id{` `value` `...` `}` `messages{` `id` `msisdn` `cost` `}` `...`	Πίνακες με id και message αντικείμενα
`accepted`	Σύνολο μηνυμάτων που έγιναν δεκτά
`rejected`	Σύνολο απορριφθέντων μηνυμάτων
`balance`	Υπόλοιπο λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`501`	Απουσιάζουν οι παράμετροι `to`, `contactId` ή `groupId`
`503`	Η παράμετρος `from` δεν έχει εγκριθεί. Μπορείτε να κάνεται αίτηση για την έγκριση αποστολέα απο το Viber
`504`	Ο αποστολέας βρίσκεται σε παύση χρήσης. Επικοινωνήστε μαζί μας ώστε να ενεργοποιηθεί και πάλι.
`505`	Δεν εισάγατε το κείμενο του Viber μηνύματος. Το κουμπί πρέπει να συνοδεύει κείμενο
`506`	Το κείμενο του Viber μηνύματος δεν μπορεί να είναι πάνω απο 1000 χαρακτήρες
`507`	Απουσιάζει η επιγραφή του κουμπιού `button_caption`
`508`	Απουσιάζει η παράμετρος `button_action`
`509`	Απουσιάζει η παράμετρος `image`
`510`	Μη έγκυρη παράμετρος `all_devices`
`511`	Μηνύματα με εικόνα και κείμενο πρέπει να περιέχουν και κουμπί
`512`	Μηνύματα χωρίς κείμενο μπορούν να έχουν μόνο εικόνα
`513`	Μη έγκυρη παράμετρος `validity`. Έγκυρες τιμές είναι από 30 (λεπτά) ως 1440 (λεπτά = 24 ώρες)
`514`	Μη έγκυρος αποστολέας `sms_from` του fall-back sms.
`515`	Μη έγκυρη παράμετρος `contactId`
`516`	Μη έγκυρη παράμετρος `groupId`
`517`	Ανεπαρκές υπόλοιπο λογαριασμού
`518`	Το μήνυμα απέτυχε να σταλεί

<?php

  $endpoint = 'https:///viber/bulk';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'text'    => 'Your Viber message',
      'from'    => 'sender',
      'to'      => '306971000000,306940000000,491725984200',
      'button_caption' => 'BUTTON',
      'button_action'  => 'YOUR-URL',
      'image'          => 'IMAGE-URL',
      'validity'       => '600',
      'sms_fallback'   => true,
      'sms_from'       => 'ORIGINATOR',
      'sms_text'       => 'Your sms message',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/bulk?\
key=YOUR-API-KEY&\
text=your_viber_message&\
from=sender&\
to=306971000000,306940000000,491725984200&\
button_caption=BUTTON&\
button_action=YOUR-URL&\
image=IMAGE-URL&\
validity=600&\
sms_fallback=true&\
sms_from=ORIGINATOR&\
sms_text=your_sms_message&\
type=xml"

api/viber/balance

Επιστρέφει λίστα με τους αποστολείς που έχουν εγκριθεί απο το Viber και το υπόλοιπο του καθενός
Απαιτείται IP Whitelist

https://easysms.gr/api/viber/balance

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`senders{` `sender{` `senderId` `text` `balance` `twoway` `paused` `}` `}`	Αντικείμενο senders για κάθε αποστολέα που έχει εκγριθεί από το Viber. Ο κάθε λογαριασμός μπορεί να έχει περισσότερους από 1 αποστολείς Viber
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///viber/balance';

  $parameters = array(
      'key'     => 'YOUR API KEY',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///viber/balance?\
key=YOUR-API-KEY&\
type=xml"

api/me

Κλήσεις διαχείρισης του λογαριασμού

api/me/balance

Επιστρέφει το υπόλοιπο του λογαριασμού

Alias της api/balance/get (παλαιότερο API v.2)
Απαιτείται IP Whitelist

https://easysms.gr/api/me/balance

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`balance`	Το υπόλοιπο του λογαριασμού
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]

<?php

  $endpoint = 'https:///me/balance';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///me/balance?\
key=YOUR-API-KEY&\
type=xml"

api/2fa

Κλήσεις send και check για αυθεντικοποίηση 2 παραγόντων (2-Factor Authentication).

Είναι ο ίδιος μηχανισμός αυθεντικοποίησης που χρησιμοποιούν οι τράπεζες και βασίζεται στις αρχές:

α. Κάτι που ξέρεις (username, password) και
β. Κάτι που έχεις (κινητό)

api/2fa/send

Στέλνει ένα κωδικό αυθεντικοποίησης με μήνυμα και επιστρέφει την κατάσταση του μηνύματος (αν παραδόθηκε d, αν απέτυχε f ή s αν δεν υπάρχει αναφορά παράδοσης ακόμα).

Με την παράμετρο wait ορίζετε το μέγιστο χρόνο σε δευτερόλεπτα που να περιμένει για την αναφορά παράδοσης.

Με την παράμετρο callback ορίζετε URL που θα κληθεί σε πραγματικό χρόνο μόλις έρθει η αναφορά παράδοσης.

Αν παραλείπονται οι παράμετροι wait και callback τότε η κλήση θα περιμένει μέχρι 10 δευτερόλεπτα για την αναφορά.
Η κλήση θα επιστρέψει αμέσως αν έχει οριστεί η callback παράμετρος και θα κληθεί το URL αυτό αμέσως μόλις έρθει η αναφορά παράδοσης.
Απαιτείται IP Whitelist

https://easysms.gr/api/2fa/send

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`to`	Κινητό	Αριθμός κινητού παραλήπτη. [Απαιτείται]
`text`	Text	Το κείμενο του μηνύματος. Αν περιέχει το κείμενο %%CODE%% αυτό θα αντικατασταθεί με τυχαίο 4-ψήφιο αριθμό
`from`	From	Αποστολέας του μηνύματος
`wait`	Seconds	Χρόνος αναμονής αναφοράς παράδοσης
`callback`	URL	URL αναφοράς παράδοσης
`ucs`	Unicode	`true` για Unicode ή `false` για GSM κωδικοποίηση (προκαθορισμένη)
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`authId`	Μοναδικός αριθμός για την κάθε αυθεντικοποίηση, απαιτούμενη παράμετρος για την κλήση `2fa/check`
`authStatus`	Παίρνει τις τιμές `d` παραδόθηκε, `f` απέτυχε ή `s` στάλθηκε, αναμονή αναφοράς παράδοσης
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`102`	Η παράμετρος `to` είναι κενή
`103`	Μη έγκυρη παράμετρος `to`. Η κλήση `api/mobile/check` θα ελέγξει τάχιστα οποιοδήποτε κινητό για εγκυρότητα
`105`	Ο λογαριασμός δεν έχει αρκετό υπόλοιπο για την αποστολή
`106`	Το μήνυμα δεν μπόρεσε να μπεί στην ουρά αποστολής

<?php

  $endpoint = 'https:///2fa/send';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'to'      => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///2fa/send?\
key=YOUR-API-KEY&\
to=306971000000&\
type=xml"

api/2fa/check

Ελέγχει αν η παράμετρος code είναι o σωστός κωδικός αυθεντικοποίησης και επιστρέφει ok αν είναι ή nok αν δεν είναι σωστός.
Απαιτείται IP Whitelist

https://easysms.gr/api/2fa/check

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`authId`	authId	Κωδικός μηνύματος αυθεντικοποίησης που επέστρεψε η `2fa/send`. [Απαιτείται]
`code`	Code	Ο κωδικός αυθεντικοποίησης για έλεγχο. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`auth`	`ok` αν έγινε αυθεντικοποίηση ή `nok` αν δεν έγινε
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`300`	Δεν ορίστηκε παράμετρος `authId`
`301`	Δεν ορίστηκε παράμετρος `code`
`302`	Δεν βρέθηκε μήνυμα αυθεντικοποίησης με κωδικό `authId`

<?php

  $endpoint = 'https:///2fa/check';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'authId'  => 'AUTH ID' ,
      'code'    => 'USER INPUT',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///2fa/check?\
key=YOUR-API-KEY&\
authId=AUTH ID&\
code=USER INPUT&\
type=xml"

api/contact

Οι κλήσεις api/contact/* επιτρέπουν στις εφαρμογές σας πλήρη διαχείριση των επαφών των λογαριασμών και των υπο-λογαριασμών

api/contact/add

Προσθέτει μια νέα επαφή στην λίστα των επαφών και επιστρέφει το contactId. Για να προστεθεί οποιαδήποτε επαφή σε ομάδα θα πρέπει να γίνει κλήση της εντολής api/group/addContact
Απαιτείται IP Whitelist

https://easysms.gr/api/contact/add

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`mobile`	Κινητό	Ο αριθμός κινητού της επαφής. [Απαιτείται]
`name`	Όνομα	Όνομα της επαφής
`surname`	Επώνυμο	Επώνυμο επαφής
`fullname`	Ονοματεπώνυμο	Ονοματεπώνυμο επαφής
`vname`	Όνομα κλ.	Όνομα σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
`vsurname`	Επώνυμο κλ.	Επώνυμο σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
`birthday`	Γενέθλια	Γενέθλια σε μορφή `YYYY-MM-DD`
`nameday`	Ονομαστική	Ονομαστική εορτή σε μορφή `YYYY-MM-DD`
`custom1`	Βοηθ. πεδίο 1	Βοηθητικό πεδίο 1. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 2	Βοηθητικό πεδίο 2. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 3	Βοηθητικό πεδίο 3. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 4	Βοηθητικό πεδίο 4. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 5	Βοηθητικό πεδίο 5. Μπορείτε να εισάγετε οτιδήποτε
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`contactId`	Το `contactId` της νέας επαφής
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`201`	Η παράμετρος `mobile` δεν αντιστοιχίζεται σε MSISDN (διεθνή μορφή αριθμών κινητών τηλεφώνων)
`202`	Το `mobile` υπάρχει ήδη σε άλλη επαφή
`203`	Το `mobile` έχει ζητήσει εξαίρεση (Opt-Out) από τις αποστολές σας
`204`	Η επαφή δεν μπόρεσε να εισαχθεί
`205`	Δεν υπάρχει η παράμετρος `mobile`

<?php

  $endpoint = 'https:///contact/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'mobile'    => '44123456789',
      'name'      => 'Joe',
      'surname'   => 'Doe',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/add?\
key=YOUR-API-KEY&\
mobile=44123456789&\
name=Joe&\
surname=Doe&\
type=xml"

api/contact/delete

Διαγράφει μια επαφή από την λίστα των επαφών και όλες τις αναφορές της επαφής σε ομάδες
Απαιτείται IP Whitelist

https://easysms.gr/api/contact/delete

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`contactId`	contactId	Το `contactId` της επαφής προς διαγραφή. Λίστα όλων των επαφών του λογαριασμού επιστρέφεται με την κλήση api/contact/list. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`214`	Δεν υπάρχει παράμετρος `contactId`
`216`	Δεν βρέθηκε επαφή με αυτό το `contactId`

<?php

  $endpoint = 'https:///contact/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/delete?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"

api/contact/get

Επιστρέφει μια επαφή από την λίστα επαφών και τις αναφορές της επαφής σε ομάδες
Απαιτείται IP Whitelist

https://easysms.gr/api/contact/get

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`contactId`	contactId	Το `contactId` της επαφής. Λίστα με όλες τις επαφές επιστρέφεται από την κλήση api/contact/list. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`contact{` `contactId` `mobile` `name` `surname` `vname` `vsurname` `birthday` `nameday` `custom1` `custom2` `custom3` `custom4` `custom5` `groups{` `group{` `groupId` `name` `}` `}`	Αντικείμενο επαφής
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`214`	Δεν υπάρχει παράμετρος `contactId`
`216`	Δεν βρέθηκε επαφή με αυτό το `contactId`

<?php

  $endpoint = 'https:///contact/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/get?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"

api/contact/list

Επιστρέφει λίστα όλων των επαφών
Απαιτείται IP Whitelist

https://easysms.gr/api/contact/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`contacts{` `contact{` `contactId` `name` `mobile` `cost` `surname` `vname` `vsurname` `birthday` `nameday` `custom1` `custom2` `custom3` `custom4` `custom5` `}` `}`	Πίνακα με αντικείμενα επαφών
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///contact/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/list?\
key=YOUR-API-KEY&\
type=xml"

api/contact/update

Ενημερώνει μια επαφή με νέα πεδία
Απαιτείται IP Whitelist

https://easysms.gr/api/contact/update

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`contactId`	contactId	Το `contactId` της επαφής. [Απαιτείται]
`mobile`	Κινητό	Νέο κινητό
`name`	Όνομα	Όνομα επαφής
`surname`	Επώνυμο	Επώνυμο
`fullname`	Ονοματεπώνυμο	Ονοματεπώνυμο
`vname`	Όνομα κλ.	Όνομα σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
`vsurname`	Επώνυμο κλ.	Επώνυμο σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
`birthday`	Γενέθλια	Γενέθλια σε μορφή `YYYY-MM-DD`
`nameday`	Ονομαστική	Ονομαστική εορτή σε μορφή `YYYY-MM-DD`
`custom1`	Βοηθ. πεδίο 1	Βοηθητικό πεδίο 1. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 2	Βοηθητικό πεδίο 2. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 3	Βοηθητικό πεδίο 3. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 4	Βοηθητικό πεδίο 4. Μπορείτε να εισάγετε οτιδήποτε
`custom1`	Βοηθ. πεδίο 5	Βοηθητικό πεδίο 5. Μπορείτε να εισάγετε οτιδήποτε
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`contactId`	Id of the updated contact
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`201`	Η παράμετρος `mobile` δεν αντιστοιχίζεται σε MSISDN (διεθνή μορφή αριθμών κινητών τηλεφώνων)
`202`	`mobile` υπάρχει ήδη σε άλλη επαφή
`203`	Το `mobile` έχει ζητήσει εξαίρεση (Opt-Out) από τις αποστολές σας
`214`	Δεν υπάρχει παράμετρος `contactId`
`221`	Σφάλμα ενημέρωσης, η επαφή δεν ενημερώθηκε

<?php

  $endpoint = 'https:///contact/udpate';

  $parameters = array(
      'key'         => 'YOUR API KEY',
      'contactId'   => 'CONTACT-ID',
      'mobile'      => '44123456789',
      'name'        => 'Joe',
      'surname'     => 'Doe',

      'type'        => 'json' // type of return format

      'type'        => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///contact/update?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
mobile=44123456789&\
name=Joe&\
surname=Doe&\
vname=Joe&\
vsurname=Doe&\
fullname=Joe-Doe&\
birthday=1980-12-24&\
nameday=1980-05-15&\
custom1=any-data-1\
custom2=any-data-2&\
custom3=any-data-3&\
custom4=any-data-4&\
custom5=any-data-5&\
type=xml"

api/group

Οι κλήσεις api/group/* επιτρέπουν πλήρη διαχείριση των ομάδων επαφών του κάθε λογαριασμού και υπο-λογαριασμών

api/group/add

Προσθέτει μια νέα ομάδα επαφών και επιστρέφει το groupId της νέας ομάδας.
Για να προσθήκη επαφών σε ομάδα πρέπει να χρησιμοποιηθεί η κλήση api/group/addContact ή παρόμοια
Απαιτείται IP Whitelist

https://easysms.gr/api/group/add

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`name`	Όνομα	Όνομα ομάδας
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`groupId`	Το `groupId` της νέας ομάδας
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`213`	Δεν υπάρχει η παράμετρος `name`

<?php

  $endpoint = 'https:///group/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'name'      => 'Group name',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/add?\
key=YOUR-API-KEY&\
name=Group-Name&\
type=xml"

api/group/addContact

Προσθέτει μια επαφή σε μια ομάδα
Απαιτείται IP Whitelist

https://easysms.gr/api/group/addContact

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`groupId`	groupId	Το `groupId` της ομάδας
`contactId`	contactId	Το `contactId` της επαφής που πρέπει να προστεθεί στην ομάδα επαφών
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`contactGroupId`	Κωδικός αναφορά της επαφής στην ομάδα
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`214`	Δεν υπάρχει παράμετρος `contactId`
`215`	Λείπει η παράμετρος `groupId`
`216`	Δεν βρέθηκε επαφή με αυτό το `contactId`
`217`	Δεν βρέθηκε το `groupId`
`218`	Η επαφή `contactId` υπάρχει ήδη στην ομάδα `groupId`. Μπορεί να μεταφραστεί σαν επιτυχία :!)

<?php

  $endpoint = 'https:///group/addContact';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/addContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"

api/group/delete

Διαγράφει μια ομάδα επαφών και όλες τις αναφορές επαφών στην ομάδα.
Σημειώστε οτι οι επαφές εξακολουθούν να υπάρχουν στην λίστα επαφών όπως και οι αναφορές τους στις υπόλοιπες ομάδες
Απαιτείται IP Whitelist

https://easysms.gr/api/group/delete

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`groupId`	groupId	To `groupId` της ομάδας προς διαγραφή. Λίστα με όλες τις ομάδες επιστρέφεται από την κλήση api/group/list. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`215`	Λείπει η παράμετρος `groupId`
`217`	Δεν βρέθηκε το `groupId`

<?php

  $endpoint = 'https:///group/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/delete?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/deleteAllContacts

Διαγραφή όλων των αναφορών σε επαφές από μια ομάδα. Αποτέλεσμα της κλήσης αυτής είναι άδεια ομάδα.
Σημειώστε οτι οι επαφές της ομάδας εξακολουθούν να υπάρχουν στην λίστα των επαφών
Απαιτείται IP Whitelist

https://easysms.gr/api/group/deleteAllContacts

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`groupId`	groupId	Το `groupId` της ομάδας προς διαγραφή. Λίστα με όλες τις ομάδες επιστρέφει η κλήση api/group/list. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`215`	Λείπει η παράμετρος `groupId`
`217`	Δεν βρέθηκε το `groupId`

<?php

  $endpoint = 'https:///group/deleteAllContacts';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/deleteAllContacts?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/deleteContact

Διαγράφει την αναφορά μιας επαφής σε ομάδα επαφών.
Για διαγραφή επαφής από την λίστα επαφών και όλες τις αναφορές της σε ομάδες πρέπει να χρησιμοποιηθεί η κλήση api/contact/delete
Απαιτείται IP Whitelist

https://easysms.gr/api/group/deleteContact

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`groupId`	groupId	Το `groupId` από το οποίο θέλετε να διαγραφεί η αναφορά στο `contactId`. [Απαιτείται με το contactId αν δεν δίνεται το contactGroupId]
`contactId`	contactId	Το `contactId` της επαφής που πρέπει να διαγραφεί η αναφορά. [Απαιτείται με το groupId αν δεν δίνεται το contactGroupId]
`contactGroupId`	contactGroupId	Κωδικός αναφοράς `contactGroupId` της επαφής στην ομάδα. [Απαιτείται αν δεν δίνονται groupId και contactId]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`215`	Λείπει η παράμετρος `groupId`
`217`	Δεν βρέθηκε το `groupId`

<?php

  $endpoint = 'https:///group/deleteContact';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',
      'contactId' => 'CONTACT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/deleteContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"

api/group/get

Επιστρέφει μια ομάδα και όλες τις αναφορές επαφών στην ομάδα αυτή
Απαιτείται IP Whitelist

https://easysms.gr/api/group/get

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`groupId`	groupId	Το `groupId` της ομάδας. Λίστα με όλες τις ομάδες επαφών επιστρέφεται από την κλήση api/group/list. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`group{` `name` `total` `contacts{` `contact{` `contactId` `mobile` `...` `}` `...` `}`	Αντικείμενο group με λίστα όλων των επαφών της ομάδας
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`215`	Λείπει η παράμετρος `groupId`
`217`	Δεν βρέθηκε το `groupId`

<?php

  $endpoint = 'https:///group/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'groupId'   => 'GROUP-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/get?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"

api/group/list

Επιστρέφει λίστα με όλες τις ομάδες επαφών
Απαιτείται IP Whitelist

https://easysms.gr/api/group/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`groups{` `group{` `groupId` `name` `}` `...` `}`	Πίνακας αντικειμένων group
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///group/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///group/list?\
key=YOUR-API-KEY&\
type=xml"

api/history

Δίνει πρόσβαση στο ιστορικό αποστολών κάθε λογαριασμού

api/history/group/list

Επιστρέφει λίστα όλων των ομαδικών αποστολών
Απαιτείται IP Whitelist

https://easysms.gr/api/history/group/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`historyGroup{` `groupId` `sender` `flash` `unicode` `timestamp` `text` `total` `cost` `sms{` `smsId` `contactId` `to` `status` `cost` `ttd` `}` `}` `...`	Πίνακας historyGroup αντικειμένων
`total`	Σύνολο επιστρεφόμενων historyGroup εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///history/group/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///history/group/list?\
key=YOUR-API-KEY&\
type=xml"

api/history/single/list

Επιστρέφει λίστα όλων των αποστολών απλών μηνυμάτων
Απαιτείται IP Whitelist

https://easysms.gr/api/history/single/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`sms{` `smsId` `sender` `to` `flash` `unicode` `timestamp` `text` `cost` `status` `ttd` `}` `...`	Πίνακας μηνυμάτων
`total`	Σύνολο μηνυμάτων
`cost`	Συνολικό κόστος μηνυμάτων που έχουν επιστραφεί
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///history/single/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///history/single/list?\
key=YOUR-API-KEY&\
type=xml"

api/hlr

Οι κλήσεις api/hlr/* εκτελούν απ'ευθείας ερωτήσεις στα δίκτυα κινητής τηλεφωνίας για να επιστρέψουν πληροφορίες φορητότητας αριθμών (portability) ή/και τοποθεσίας (geo location) για κινητά τηλέφωνα.

Το HLR lookup (Home Location Register) είναι χρήσιμο για βελτιστοποίηση δρομολόγησης μηνυμάτων αλλά κυρίως για υπηρεσίες αυθεντικοποίησης και συντήρησης βάσεων δεδομένων.

Η κάθε κλήση της api/hlr/lookup κοστίζει το 1/10 του μηνύματος, δηλαδή μόνο 0.0035€

api/hlr/lookup

Δέχεται παραμέτρους το API key του λογαριασμού και οποιοδήποτε κινητό τηλέφωνο για το οποίο θα γίνει η ερώτηση.

Η κάθε κλήση της api/hlr/lookup κοστίζει το 1/10 ενός μηνύματος και αφαιρείται από την ιδιότητα hlrBalance του λογαριασμού.

To hlrBalance του κάθε λογαριασμού αρχικά είναι 0.

Μόλις κληθεί η api/hlr/lookup ελέγχει αν το hlrBalance είναι τουλάχιστον 1 και αν είναι 0 τότε αφαιρεί 1 SMS από το balance του λογαριασμού και το μετατρέπει σε 10 hlrBalance credits.

https://easysms.gr/api/hlr/lookup

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`mobile`	Κινητό	Οποιοσδήποτε αριθμός κινητού για έλεγχο. Παγκόσμια κάλυψη. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`result`	Αποτέλεσμα της κλήσης, επιτυχής αν είναι `OK`
`description`	Περιγραφή του αποτελέσματος της κλήσης
`mcc`	O τρέχων κωδικός χώρας για το κινητό που έγινε η ερώτηση
`mnc`	Ο τρέχων κωδικός δικτύου
`network`	Το όνομα του δικτύου που ανήκει
`country`	Όνομα χώρας
`countryCode`	Κωδικός κλήσης της χώρας
`ported`	`yes` αν έχει μεταφερθεί σε άλλο δίκτυο από το αρχικό
`cctld`	CCTLD της χώρας
`mccInitial`	Αρχικός κωδικός χώρας
`mncInitial`	Αρχικός κωδικός δικτύου
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`105`	Ο λογαριασμός έχει υπόλοιπο 0
`201`	Η παράμετρος `mobile` δεν αντιστοιχίζεται σε MSISDN (διεθνή μορφή αριθμών κινητών τηλεφώνων)
`205`	Η παράμετρος `mobile` είναι κενή

<?php

  $endpoint = 'https:///hlr/lookup';

  $parameters = array(
      'key'     => 'YOUR API KEY',
      'mobile'  => '306971000000',

      'type'    => 'json' // type of return format

      'type'    => 'xml'  // type of return format

      'type'    => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///hlr/lookup?\
key=YOUR-API-KEY&\
mobile=MOBILE NUMBER&\
type=xml"

api/purchase

Δίνει πρόσβαση στο ιστορικό αγορών μηνυμάτων

api/purchase/list

Επιστρέφει λίστα με όλες τις αγορές μηνυμάτων
Απαιτείται IP Whitelist

https://easysms.gr/api/purchase/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`purchases{` `purchase{` `purchaseId` `timestamp` `cost` `sms` `}` `...` `}`	Πίνακας αγορών
`total`	Συνολικός αριθμός αγορών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///purchase/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///purchase/list?\
key=YOUR-API-KEY&\
type=xml"

api/status

Επιστρέφει την τρέχουσα κατάσταση των απεσταλμένων μηνυμάτων

api/status/get

Επιστρέφει όλα τα μηνύματα των οποίων η κατάσταση άλλαξε από την τελευταία κλήση της
Απαιτείται IP Whitelist

https://easysms.gr/api/status/get

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`sms{` `smsId` `status` `}` `...`	Πίνακας κωδικών sms και καταστάσεων
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///status/get';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///status/get?\
key=YOUR-API-KEY&\
type=xml"

api/status/sms

Επιστρέφει την κατάσταση ενός μηνύματος
Απαιτείται IP Whitelist

https://easysms.gr/api/status/sms

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`smsId`	smsId	Ο κωδικός του μηνύματος. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`sms{` `smsId` `status` `}`	Η κατάσταση του μηνύματος smsId
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///status/sms';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'smsid'     => 'SMS ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///status/sms?\
key=YOUR-API-KEY&\
smsId=SMS-ID&\
type=xml"

api/user

Διαχείριση λογαριασμού και υπο-λογαριασμών.

Περισσότερες κλήσης θα είναι διαθέσιμες σύντομα:

api/user/delete
api/user/email
api/user/emailAll
api/user/get
api/user/password
api/user/sms
api/user/smsAll
api/user/update

api/user/add

Προσθήκη νέου υπο-λογαριασμού
Απαιτείται IP Whitelist

https://easysms.gr/api/user/add

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του κύριου λογαριασμού. [Απαιτείται]
`email`	email	Το `email` του χρήστη που θα δημιουργηθεί. [Απαιτείται]
`password`	password	Ο κωδικός πρόσβασης του χρήστη. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`user{` `userId` `balance` `}`	Υπόλοιπο μηνυμάτων του χρήστη
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]
`601`	Υπάρχει ήδη χρήστης
`602`	Φτάσατε το μέγιστο αριθμό χρηστών. Επικοινωνήστε μαζί μας

<?php

  $endpoint = 'https:///user/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'email'     => 'VALID-EMAIL',
      'password'  => 'PASSWORD',
          'type'      => 'json' // type of return format
          'type'      => 'xml'  // type of return format
          'type'      => 'v2'   // type of return format
  );
//remove_circle_outline  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }


  $json = json_decode(call_endpoint($endpoint, $parameters), true);

  echo '<pre>';
  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);

  if (function_exists('simplexml_load_string')){
    $xml = simplexml_load_string($xmldata);
  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';
  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

?>

curl "https:///user/add?\
key=YOUR-API-KEY&\
email=VALID-EMAIL&\
password=PASSWORD&\
type=xml"

api/user/list

Επιστρέφει λίστα όλων των υπο-λογαριασμών
Απαιτείται IP Whitelist

https://easysms.gr/api/user/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του λογαριασμού. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`user{` `userId` `username` `email` `balance` `mobile` `key` `}` `...`	Πίνακας χρηστών
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή

<?php

  $endpoint = 'https:///user/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/list?\
key=YOUR-API-KEY&\
type=xml"

api/user/topup

Προσθέτει μηνύματα σε ένα υπο-λογαριασμό τα οποία αφαιρούνται από τον κυρίως λογαριασμό
Απαιτείται IP Whitelist

https://easysms.gr/api/user/topup

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του κύριου λογαριασμού από τον οποίο θα αφαιρεθούν τα μηνύματα. [Απαιτείται]
`userId`	userId	Το `userId` του χρήστη που θα προστεθούν μηνύματα. [Απαιτείται]
`sms`	sms	Πόσα μηνύματα θα προστεθούν στο χρήστη. [Απαιτείται]
`cost`	cost	Το κόστος των μηνυμάτων. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`user{` `userId` `balance` `}`	Υπόλοιπο μηνυμάτων του χρήστη
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`206`	Λάθος παράμετρος `sms`
`207`	Λάθος παράμετρος `cost`
`208`	Η παράμετρος `userId` είναι κενή
`209`	Δεν βρέθηκε ο χρήστης
`210`	Αφαίρεση μηνυμάτων από υπο-λογαριασμό. Δεν υπάρχει αρκετό υπόλοιπο στον υπο-λογαριασμό
`211`	Ο κύριος λογαριασμός δεν έχει αρκετό υπόλοιπο μηνυμάτων

<?php

  $endpoint = 'https:///user/topup';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',
      'sms'       => 100,
      'cost'      => 4,

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/topup?\
key=YOUR-API-KEY&\
userId=USER-ID&\
sms=100&\
cost=4&\
type=xml"

api/user/comment

add, delete και list κλήσεις για προσθήκη σχολίων και έλεγχο του ιστορικού του κάθε υπο-λογαριασμού

api/user/comment/add

Προσθέτει ένα σχόλιο σε ένα υπο-λογαριασμό
Απαιτείται IP Whitelist

https://easysms.gr/api/user/comment/add

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του κυρίως λογαριασμού. [Απαιτείται]
`userId`	userId	Το `userId` του χρήστη. [Απαιτείται]
`comment`	Σχόλιο	Σχόλιο για προσθήκη
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`comment{` `commentId` `}`	Comment id
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`208`	Η παράμετρος `userId` είναι κενή
`209`	Δεν βρέθηκε ο χρήστης
`212`	Δεν υπάρχει η παράμετρος `comment`

<?php

  $endpoint = 'https:///user/comment/add';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',
      'comment'   => 'New comment',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/add?\
key=YOUR-API-KEY&\
userId=USER-ID&\
comment=new-comment&\
type=xml"

api/user/comment/delete

Διαγράφει σχόλιο από υπο-λογαριασμό
Απαιτείται IP Whitelist

https://easysms.gr/api/user/comment/delete

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του κύριου λογαριασμού. [Απαιτείται]
`commentId`	Comment id	Κωδικός σχολίου για διαγραφή
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`212`	Δεν υπάρχει η παράμετρος `comment`
`220`	Δεν βρέθηκε το σχόλιο `commentId`

<?php

  $endpoint = 'https:///user/comment/delete';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'commentId' => 'COMMENT-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/delete?\
key=YOUR-API-KEY&\
commentId=COMMENT-ID&\
type=xml"

api/user/comment/list

Επιστρέφει λίστα με όλα τα σχόλια ενός υπο-λογαριασμού
Απαιτείται IP Whitelist

https://easysms.gr/api/user/comment/list

Δέχεται

Παράμετρος	Τιμή	Περιγραφή
`key`	API key	Το API key του κύριου λογαριασμού. [Απαιτείται]
`userId`	userId	Το `userId` του χρήστη. [Απαιτείται]
`type`		Μορφή επιστρεφόμενου αποτελέσματος. Μπορεί να είναι απλό κείμενο (v2), `json` ή `xml`. Η προκαθορισμένη μορφή είναι `json`

Επιστρέφει

Τιμή	Περιγραφή
`comments{` `comment{` `commentId` `timestamp` `comment` `}` `...` `}`	Πίνακας με σχόλια
`total`	Σύνολο εγραφών
`status`	Η κατάσταση της κλήσης. Πάντοτε `1` για επιτυχία ή `0` για σφάλμα
`error`	Κωδικός σφάλματος, πάντοτε `0` αν δεν υπήρχε σφάλμα, διαφορετικά συμβουλευτείτε την λίστα με τους κωδικούς σφαλμάτων ή την παράμετρο `remarks`
`remarks`	Παρατηρήσεις για την κλήση. Πάντοτε `Success` για επιτυχία ή περιγραφή σφάλματος για αποτυχία

Σφάλματα

Σφάλμα	Περιγραφή
`101`	Έλεγχος API `key` λογαριασμού ή [username-password]Αναπαραγωγή
`208`	Η παράμετρος `userId` είναι κενή
`209`	Δεν βρέθηκε ο χρήστης

<?php

  $endpoint = 'https:///user/comment/list';

  $parameters = array(
      'key'       => 'YOUR API KEY',
      'userId'    => 'SUB-USER-ID',

      'type'      => 'json' // type of return format

      'type'      => 'xml'  // type of return format

      'type'      => 'v2'   // type of return format

);

  function call_endpoint($endpoint, $parameters){
      $c = curl_init();
      curl_setopt($c, CURLOPT_URL, $endpoint);
      curl_setopt($c, CURLOPT_POST, true);
      curl_setopt($c, CURLOPT_POSTFIELDS, $parameters);
      curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($c, CURLOPT_SSL_VERIFYPEER, false);
      $output =  curl_exec($c);
      curl_close($c);
      return $output;
  }

  $json = json_decode(call_endpoint($endpoint, $parameters), true);


  echo '<pre>';

  print_r($json);

  $xmldata = call_endpoint($endpoint, $parameters);


  if (function_exists('simplexml_load_string')){

    $xml = simplexml_load_string($xmldata);

  }else if (function_exists('xml_parser_create')){
    $xmlparser = xml_parser_create();
    xml_parse_into_struct($xmlparser, $xmldata, $xml);
    xml_parser_free($xmlparser);
  }

  echo '<pre>';

  print_r($xml);

  echo call_endpoint($endpoint, $parameters);

curl "https:///user/comment/list?\
key=YOUR-API-KEY&\
userId=USER-ID&\
type=xml"

thank you, thank you

myschool.sch.gr

Όλες οι σχολικές μονάδες και σχολικές επιτροπές μπορούν να διασυνδέσουν το σύστημα διαχείρισης myschool.sch.gr με το easysms.gr και να κάνουν απευθείας αποστολές μηνυμάτων από το myschool προς

Μαθητές
Γονείς
Εκπαιδευτικό προσωπικό και άλλους

Σελίδα παραμετροποίησης myschool

Στο πεδίο 1. εισάγετε το κλειδί του λογαριασμού σας
Θα το βρείτε μόλις συνδεθείτε με τον λογαριασμό σας στην υπηρεσία

Στο πεδίο 2. εισάγετε τον αποστολέα των μηνυμάτων
Παράδειγμα έγκυρου αποστολέα 11 χαρακτήρων 1Gym-Lamias

Πρέπει να είναι μέχρι 11 λατινικούς χαρακτήρες χωρίς κενά
Επιτρέπονται μόνο τα σύμβολα + - . ! : ;
συν, πλην, τελεία, θαυμαστικό, άνω-κάτω τελεία, ερωτηματικό

- graphic_eq
- face
- settings
GENERAL SETTINGS
- Notifications
  
  Use checkboxes when looking for yes or no answers.
- Show recent activity
  
  The for attribute is necessary to bind our custom checkbox with the input.
- Notifications
  
  Use checkboxes when looking for yes or no answers.
- Show recent activity
  
  The for attribute is necessary to bind our custom checkbox with the input.
- Show your emails
  
  Use checkboxes when looking for yes or no answers.
- Show Task statistics
  
  The for attribute is necessary to bind our custom checkbox with the input.
Elizabeth Elliott 5.00 AM
Thank you
Mary Adams 4.14 AM
Hello Boo
Caleb Richards 9.00 PM
Keny !
June Lane 4.14 AM
Ohh God
Edward Fletcher 5.15 PM
Love you
Crystal Bates 8.00 AM
Can we
Nathan Watts 9.53 PM
Great!
Willard Wood 4.20 AM
Do it
Ronnie Ellis 5.30 PM
Got that
Gwendolyn Wood 4.34 AM
Like you
Daniel Russell 12.00 AM
Thank you
Sarah Graves 11.14 PM
Okay you
Andrew Hoffman 7.30 PM
Can do
Camila Lynch 2.00 PM
Leave it

RECENT ACTIVITY

just now
Jim Doe Purchased new equipments for zonal office.

Yesterday
Your Next flight for USA will be on 15th August 2015.

5 Days Ago
Natalya Parker Send you a voice mail for next conference.

1 Week Ago
Jessy Jay open a new store at S.G Road.

2 Week Ago
voice mail for conference.

1 Month Ago
Natalya Parker Send you a voice mail for next conference.

3 Month Ago
Jessy Jay open a new store at S.G Road.

1 Year Ago
voice mail for conference.

Γενικά

Δημιουργια λογαριασμου

IP whitelist για το API

Αυθεντικοποιηση

REST SMS API

api/mobile

api/mobile/check

api/key

api/key/get

api/key/reset

api/sms

api/sms/bulk

api/sms/cancel

api/sms/send

api/viber

api/viber/send

api/viber/bulk

api/viber/balance

api/me

api/me/balance

api/2fa

api/2fa/send

api/2fa/check

api/contact

api/contact/add

api/contact/delete

api/contact/get

api/contact/list

api/contact/update

api/group

api/group/add

api/group/addContact

api/group/delete

api/group/deleteAllContacts

api/group/deleteContact

api/group/get

api/group/list

api/history

api/history/group/list

api/history/single/list

api/hlr

api/hlr/lookup

api/purchase

api/purchase/list

api/status

api/status/get

api/status/sms

api/user

api/user/add

api/user/list

api/user/topup

api/user/comment

api/user/comment/add

api/user/comment/delete

api/user/comment/list

myschool.sch.gr