Function GetCircuits

Τηλεπικοινωνιακά Κυκλώματα

Η συνάρτηση αυτή επιστρέφει όλα τα Τηλεπικοινωνιακά Κυκλώματα σύμφωνα με τις παραμέτρους που έγινε η κλήση

Η κλήση μπορεί να γίνει μέσω της παρακάτω διεύθυνσης με τη μέθοδο GET :
https://mm.sch.gr/api/circuits

Τα αποτελέσματα είναι ταξινομημένα ως προς τον Κωδικό ΜΜ της Μονάδας
Μέσω των παραμέτρων Πεδίο Ταξινόμησης ($orderby) και Τύπος Ταξινόμησης ($ordertype) μπορεί να καθοριστεί το πεδίο και η σειρά ταξινόμησης

Πίνακας Παραμέτρων
Στον Πίνακα Παραμέτρων Parameters summary εμφανίζονται όλοι οι παράμετροι με τους οποίους μπορεί να γίνει η κλήση της συνάρτησης
Όλοι οι παράμετροι είναι προαιρετικοί εκτός από αυτές που έχουν χαρακτηριστεί ως υποχρεωτικοί
Οι παράμετροι μπορούν να χρησιμοποιηθούν με οποιαδήποτε σειρά
Οι παράμετροι μπορούν να πάρουν τιμή "NULL" για να αναζητήσουν τις κενές εγγραφές στα αντίστοιχα πεδία

Πίνακας Αποτελεσμάτων
Στον Πίνακα Αποτελεσμάτων Return value summary εμφανίζονται οι μεταβλητές που επιστρέφει η συνάρτηση
Όλες οι μεταβλητές επιστρέφονται σε ένα πίνακα σε JSON μορφή
Η μεταβλητή data είναι ο πίνακας με το λεξικό
Η μεταβλητή status καθορίζει αν η εκτέλεση της συνάρτησης ήταν επιτυχής (κωδικός 200) ή προέκυψε κάποιο σφάλμα

Πίνακας Σφαλμάτων
Στον Πίνακα Σφαλμάτων Thrown exceptions summary εμφανίζονται τα Μηνύματα Σφαλμάτων που μπορεί να προκύψουν κατά την κλήση της συνάρτησης
Οι περιγραφές των Σφαλμάτων καθώς και οι Κωδικοί τους είναι διαθέσιμες μέσω του πίνακα Μηνύματα Σφαλμάτων (ExceptionMessages) και Κωδικοί Σφαλμάτων (ExceptionCodes) αντίστοιχα

Παραδείγματα Κλήσης
Παρακάτω εμφανίζεται μια σειρά από παραδείγματα κλήσης της συνάρτησης με διάφορους τρόπους :
cURL | JavaScript | PHP | Ajax

Παράδειγμα κλήσης της συνάρτησης με cURL (console) :

curl -X GET https://mm.sch.gr/api/circuits \
   -H "Content-Type: application/json" \
   -H "Accept: application/json" \
   -u username:password \
   -d '{"circuit_type": "ISDN ADSL"}'

Παράδειγμα κλήσης της συνάρτησης με JavaScript :

<script>
   var params = JSON.stringify({ "circuit_type": "ISDN ADSL" });

   var http = new XMLHttpRequest();
   http.open("GET", "https://mm.sch.gr/api/circuits");
   http.setRequestHeader("Accept", "application/json");
   http.setRequestHeader("Content-type", "application/json; charset=utf-8");
   http.setRequestHeader("Authorization", "Basic " + btoa('username' + ':' + 'password') );

   http.onreadystatechange = function()
   {
       if(http.readyState == 4 && http.status == 200)
       {
           var result = JSON.parse(http.responseText);
           document.write(result.status + " : " + result.message + " : " + result.data);
       }
   }

   http.send(params);
</script>

Παράδειγμα κλήσης της συνάρτησης με PHP :

<?php
   header("Content-Type: text/html; charset=utf-8");

   $params = array("circuit_type" => "ISDN ADSL");

   $curl = curl_init("https://mm.sch.gr/api/circuits");

   curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
   curl_setopt($curl, CURLOPT_USERPWD, "username:password");
   curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "GET");
   curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

   $data = curl_exec($curl);
   $data = json_decode($data);
   echo "<pre>"; var_dump( $data ); echo "</pre>";
?>

Παράδειγμα κλήσης της συνάρτησης με Ajax :

<script>
   $.ajax({
       type: 'GET',
       url: 'https://mm.sch.gr/api/circuits',
       dataType: "json",
       data:{'circuit_type': 'ISDN ADSL'},
       beforeSend: function(req) {
           req.setRequestHeader('Authorization', btoa('username' + ":" + 'password'));
       },
       success: function(data){
           console.log(data);
       }
   });
</script>

Πίνακας Δεδομένων
Παρακάτω εμφανίζεται ένα δείγμα του λεξικού σε μορφή JSON :

{"data":[
        {
                "circuit_id": 10382,
                "phone_number": "2109373724",
                "status": 1,
                "paid_by_psd": 1,
                "activated_date": "2000-03-09 16:07:00",
                "updated_date": "2013-12-18 16:07:00",
                "deactivated_date": null,
                "bandwidth": "24576/1024Kbps",
                "readspeed": null,
                "mm_id": 1000023,
                "registry_no": "0501004",
                "unit_name": "ΠΡΟΤΥΠΟ ΠΕΙΡΑΜΑΤΙΚΟ ΓΥΜΝΑΣΙΟ ΝΕΑ ΣΜΥΡΝΗ",
                "special_unit_name": "ΕΥΑΓΓΕΛΙΚΗ ΣΧΟΛΗ ΣΜΥΡΝΗΣ",
                "circuit_type_id": 2,
                "circuit_type": "aDSLoISDN"
        },
        {
                "circuit_id": 8008,
                "phone_number": "2102693119",
                "status": 1,
                "paid_by_psd": 1,
                "activated_date": null,
                "updated_date": "2013-12-13 20:06:00",
                "deactivated_date": null,
                "bandwidth": "24576/1024Kbps",
                "readspeed": null,
                "mm_id": 1000025,
                "registry_no": "0501005",
                "unit_name": "ΠΡΟΤΥΠΟ ΠΕΙΡΑΜΑΤΙΚΟ ΓΥΜΝΑΣΙΟ ΑΓ. ΑΝΑΡΓΥΡΩΝ",
                "special_unit_name": null,
                "circuit_type_id": 2,
                "circuit_type": "aDSLoISDN"
        },
        {
                "circuit_id": 6609,
                "phone_number": "2103257309",
                "status": 1,
                "paid_by_psd": 1,
                "activated_date": null,
                "updated_date": "2013-12-13 19:49:00",
                "deactivated_date": null,
                "bandwidth": "24576/1024Kbps",
                "readspeed": null,
                "mm_id": 1000027,
                "registry_no": "0501040",
                "unit_name": "1ο ΠΡΟΤΥΠΟ ΠΕΙΡΑΜΑΤΙΚΟ ΓΥΜΝΑΣΙΟ ΑΘΗΝΑΣ",
                "special_unit_name": null,
                "circuit_type_id": 2,
                "circuit_type": "aDSLoISDN"
        },
        {
                "circuit_id": 7671,
                "phone_number": "2105202994",
                "status": 1,
                "paid_by_psd": 1,
                "activated_date": null,
                "updated_date": "2013-12-13 20:02:00",
                "deactivated_date": null,
                "bandwidth": "24576/1024Kbps",
                "readspeed": null,
                "mm_id": 1000028,
                "registry_no": "0501050",
                "unit_name": "2ο ΔΙΑΠΟΛΙΤΙΣΜΙΚΟ ΓΥΜΝΑΣΙΟ ΑΘΗΝΩΝ",
                "special_unit_name": "ΓΥΜΝΑΣΙΟ ΔΙΑΠΟΛΙΤΙΣΜΙΚΗΣ ΕΚΠΑΙΔΕΥΣΗΣ Α ΑΘΗΝΑΣ",
                "circuit_type_id": 2,
                "circuit_type": "aDSLoISDN"
        },
        {
                "circuit_id": 8002,
                "phone_number": "2105786127",
                "status": 1,
                "paid_by_psd": 1,
                "activated_date": null,
                "updated_date": "2013-12-13 20:06:00",
                "deactivated_date": null,
                "bandwidth": "24576/1024Kbps",
                "readspeed": null,
                "mm_id": 1000032,
                "registry_no": "0501067",
                "unit_name": "8ο ΗΜΕΡΗΣΙΟ ΓΥΜΝΑΣΙΟ ΙΛΙΟΥ",
                "special_unit_name": null,
                "circuit_type_id": 2,
                "circuit_type": "aDSLoISDN"
        }
]}