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

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

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

 

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

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

 

IP whitelist για το API

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

 

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

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

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

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

 
 

Αυτή είναι η 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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///mobile/check?\
mobile=4412345678900"
 
 
 
 

api/key

 

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

 
 
 

api/key/get

 

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

 

Δέχεται

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

Επιστρέφει

ΤιμήΠεριγραφή
keyTo 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
  );
//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:///key/get?\
username=USERNAME&\
password=PASSWORD&\
type=xml"
 
 

api/key/reset

 

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

 

Δέχεται

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

Επιστρέφει

ΤιμήΠεριγραφή
keyTo 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
  );
//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:///key/reset?\
username=USERNAME&\
password=PASSWORD&\
type=xml"
 
 
 
 

api/sms

 

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

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

api/sms/bulk

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
to
Αριθμοί κινητών παραληπτών διαχωρισμένοι με κόμμα , [Απαιτείται]
text
Το κείμενο του μηνύματος. [Απαιτείται]
from
Αποστολέας του μηνύματος
ucs
true για Unicode ή false για GSM κωδικοποίηση (προκαθορισμένη)
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///sms/cancel?\
key=YOUR-API-KEY&\
smsId=SMSID&\
type=xml"
 
 

api/sms/send

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
to
Αριθμός κινητού παραλήπτη. [Απαιτείται]
text
Το κείμενο του μηνύματος
from
Αποστολέας του μηνύματος
ucs
true για Unicode ή false για GSM κωδικοποίηση (προκαθορισμένη)
flash
true για flash sms ή false για κανονικό (προκαθορισμένο)
timestamp
Χρόνος αποστολής εκφρασμένος σε Unix epoch timestamp. Προγραμματισμένα μηνύματα μπορούν να ακυρωθούν με την εντολή api/sms/cancel
callback
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

Επιστρέφει

ΤιμήΠεριγραφή
smsIdsmsId του μηνύματος
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';

  $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
  );
//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:///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

 

Δέχεται

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

Επιστρέφει

ΤιμήΠεριγραφή
idΤο id του μηνύματος Viber
costTo κόστος του μηνύματος Viber
balanceTo υπόλοιπο του λογαριασμού
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
to
Αριθμοί κινητών παραληπτών διαχωρισμένα με κόμμα , [Απαιτείται]
text
Το κείμενο του μηνύματος
from
Αποστολέας του μηνύματος. Ο αποστολέας πρέπει να εγκριθεί από το Viber.
button_caption
Η επιγραφή του κουμπιού
button_action
Η διεύθυνση ανακατεύθυνσης του κουμπιού
image
Η διεύθυνση της εικόνας. Πρέπει να είναι διαστάσεων 350px x 350px.
validity
Σε δευτερόλεπτα (από 60 για 1 λεπτό ώς 86400 για 24 ώρες) η περίοδος εγκυρότητας του Viber μηνύματος. Μετά το πέρας γίνεται αποστολή του fall-back SMS. Προκαθορισμένη τιμή είναι 86400 για 24 ώρες
all_devices
true για αποστολή σε Smartphones και Tablets και false για αποστολή σε Smartphones μόνο
sms_fallback
true για αποστολή Fallback SMS αν αποτύχει το Viber μήνυμα
sms_text
Το κείμενο του fall-back μηνύματος
sms_from
Ο αποστολέας του fall-back μηνύματος
ucs
Για το fall-back SMS: true για Unicode ή false για GSM κωδικοποίηση (προκαθορισμένη)
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///viber/balance?\
key=YOUR-API-KEY&\
type=xml"
 
 
 
 

api/me

 

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

 
 
 

api/me/balance

 

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

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
to
Αριθμός κινητού παραλήπτη. [Απαιτείται]
text
Το κείμενο του μηνύματος. Αν περιέχει το κείμενο %%CODE%% αυτό θα αντικατασταθεί με τυχαίο 4-ψήφιο αριθμό
from
Αποστολέας του μηνύματος
wait
Χρόνος αναμονής αναφοράς παράδοσης
callback
URL αναφοράς παράδοσης
ucs
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
  );
//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:///2fa/send?\
key=YOUR-API-KEY&\
to=306971000000&\
type=xml"
 
 

api/2fa/check

 

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

 

Δέχεται

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

Επιστρέφει

ΤιμήΠεριγραφή
authok αν έγινε αυθεντικοποίηση ή 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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
mobile
Ο αριθμός κινητού της επαφής. [Απαιτείται]
name
Όνομα της επαφής
surname
Επώνυμο επαφής
fullname
Ονοματεπώνυμο επαφής
vname
Όνομα σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
vsurname
Επώνυμο σε κλητική, κατάλληλο για προσωποποιημένα μηνύματα
birthday
Γενέθλια σε μορφή YYYY-MM-DD
nameday
Ονομαστική εορτή σε μορφή YYYY-MM-DD
custom1
Βοηθητικό πεδίο 1. Μπορείτε να εισάγετε οτιδήποτε
custom1
Βοηθητικό πεδίο 2. Μπορείτε να εισάγετε οτιδήποτε
custom1
Βοηθητικό πεδίο 3. Μπορείτε να εισάγετε οτιδήποτε
custom1
Βοηθητικό πεδίο 4. Μπορείτε να εισάγετε οτιδήποτε
custom1
Βοηθητικό πεδίο 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
  );
//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:///contact/add?\
key=YOUR-API-KEY&\
mobile=44123456789&\
name=Joe&\
surname=Doe&\
type=xml"
 
 

api/contact/delete

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///contact/delete?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"
 
 

api/contact/get

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///contact/get?\
key=YOUR-API-KEY&\
contactId=CONTACT-ID&\
type=xml"
 
 

api/contact/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///contact/list?\
key=YOUR-API-KEY&\
type=xml"
 
 

api/contact/update

 

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

 

Δέχεται

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

Επιστρέφει

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

Σφάλματα

ΣφάλμαΠεριγραφή
101Έλεγχος API key λογαριασμού ή [username-password]Αναπαραγωγή
201Η παράμετρος mobile δεν αντιστοιχίζεται σε MSISDN (διεθνή μορφή αριθμών κινητών τηλεφώνων)
202mobile υπάρχει ήδη σε άλλη επαφή
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///group/add?\
key=YOUR-API-KEY&\
name=Group-Name&\
type=xml"
 
 

api/group/addContact

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
groupId
Το groupId της ομάδας
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
  );
//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:///group/addContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"
 
 

api/group/delete

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///group/delete?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"
 
 

api/group/deleteAllContacts

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///group/deleteAllContacts?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"
 
 

api/group/deleteContact

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
groupId
Το groupId από το οποίο θέλετε να διαγραφεί η αναφορά στο contactId. [Απαιτείται με το contactId αν δεν δίνεται το contactGroupId]
contactId
Το contactId της επαφής που πρέπει να διαγραφεί η αναφορά. [Απαιτείται με το groupId αν δεν δίνεται το 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
  );
//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:///group/deleteContact?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
contactId=CONTACT-ID&\
type=xml"
 
 

api/group/get

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///group/get?\
key=YOUR-API-KEY&\
groupId=GROUP-ID&\
type=xml"
 
 

api/group/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///group/list?\
key=YOUR-API-KEY&\
type=xml"
 
 
 
 

api/history

 

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

 
 
 

api/history/group/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///history/group/list?\
key=YOUR-API-KEY&\
type=xml"
 
 

api/history/single/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///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.

 

Δέχεται

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

Επιστρέφει

ΤιμήΠεριγραφή
resultΑποτέλεσμα της κλήσης, επιτυχής αν είναι OK
descriptionΠεριγραφή του αποτελέσματος της κλήσης
mccO τρέχων κωδικός χώρας για το κινητό που έγινε η ερώτηση
mncΟ τρέχων κωδικός δικτύου
networkΤο όνομα του δικτύου που ανήκει
countryΌνομα χώρας
countryCode Κωδικός κλήσης της χώρας
portedyes αν έχει μεταφερθεί σε άλλο δίκτυο από το αρχικό
cctldCCTLD της χώρας
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
  );
//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:///hlr/lookup?\
key=YOUR-API-KEY&\
mobile=MOBILE NUMBER&\
type=xml"
 
 
 
 

api/purchase

 

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

 
 
 

api/purchase/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///purchase/list?\
key=YOUR-API-KEY&\
type=xml"
 
 
 
 

api/status

 

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

 
 
 

api/status/get

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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:///status/get?\
key=YOUR-API-KEY&\
type=xml"
 
 

api/status/sms

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του λογαριασμού. [Απαιτείται]
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
  );
//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:///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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του κύριου λογαριασμού. [Απαιτείται]
email
Το email του χρήστη που θα δημιουργηθεί. [Απαιτείται]
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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
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
  );
//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/list?\
key=YOUR-API-KEY&\
type=xml"
 
 

api/user/topup

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του κύριου λογαριασμού από τον οποίο θα αφαιρεθούν τα μηνύματα. [Απαιτείται]
userId
Το userId του χρήστη που θα προστεθούν μηνύματα. [Απαιτείται]
sms
Πόσα μηνύματα θα προστεθούν στο χρήστη. [Απαιτείται]
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
  );
//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/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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του κυρίως λογαριασμού. [Απαιτείται]
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
  );
//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/comment/add?\
key=YOUR-API-KEY&\
userId=USER-ID&\
comment=new-comment&\
type=xml"
 
 

api/user/comment/delete

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του κύριου λογαριασμού. [Απαιτείται]
commentId
Κωδικός σχολίου για διαγραφή
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
  );
//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/comment/delete?\
key=YOUR-API-KEY&\
commentId=COMMENT-ID&\
type=xml"
 
 

api/user/comment/list

 

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

 

Δέχεται

ΠαράμετροςΤιμήΠεριγραφή
key
Το API key του κύριου λογαριασμού. [Απαιτείται]
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
  );
//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/comment/list?\
key=YOUR-API-KEY&\
userId=USER-ID&\
type=xml"
 
 
thank you, thank you
 
 
 
 
 

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

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

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

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

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

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