Function DeleteConnections
Διαγραφή Διασύνδεσης
Η συνάρτηση αυτή διαγράφει τις Διασυνδέσεις σύμφωνα με τις παραμέτρους που έγινε η κλήση
Η κλήση μπορεί να γίνει μέσω της παρακάτω
διεύθυνσης με τη μέθοδο DELETE :
https://mm.sch.gr/api/connections
Πίνακας Παραμέτρων
Στον Πίνακα Παραμέτρων Parameters
summary εμφανίζονται όλοι οι παράμετροι με
τους οποίους μπορεί να γίνει η κλήση της
συνάρτησης
Όλοι οι παράμετροι είναι προαιρετικοί
εκτός από αυτές που έχουν χαρακτηριστεί ως
υποχρεωτικοί
Οι παράμετροι μπορούν να χρησιμοποιηθούν
με οποιαδήποτε σειρά
Πίνακας Αποτελεσμάτων
Στον Πίνακα Αποτελεσμάτων Return value
summary εμφανίζονται οι μεταβλητές που
επιστρέφει η συνάρτηση
Όλες οι μεταβλητές επιστρέφονται σε ένα
πίνακα σε JSON μορφή
Η μεταβλητή data είναι ο πίνακας με το
λεξικό
Η μεταβλητή status καθορίζει αν η εκτέλεση της
συνάρτησης ήταν επιτυχής (κωδικός 200) ή
προέκυψε κάποιο σφάλμα
Πίνακας Σφαλμάτων
Στον Πίνακα Σφαλμάτων Thrown exceptions
summary εμφανίζονται τα Μηνύματα Σφαλμάτων
που μπορεί να προκύψουν κατά την κλήση της
συνάρτησης
Οι περιγραφές των Σφαλμάτων καθώς και οι
Κωδικοί τους είναι διαθέσιμες μέσω του
πίνακα Μηνύματα Σφαλμάτων (ExceptionMessages)
και Κωδικοί Σφαλμάτων (ExceptionCodes)
αντίστοιχα
Παραδείγματα Κλήσης
Παρακάτω εμφανίζεται μια σειρά από
παραδείγματα κλήσης της συνάρτησης με
διάφορους τρόπους :
cURL | JavaScript | PHP | Ajax
Παράδειγμα κλήσης της μεθόδου με cURL (console) :
curl -X DELETE https://mm.sch.gr/api/connections \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -u username:password \ -d { "connection_id" : "100" }'
Παράδειγμα κλήσης της μεθόδου με JavaScript :
<script> var params = JSON.stringify({"connection_id" : "100"}); var http = new XMLHttpRequest(); http.open("DELETE", "https://mm.sch.gr/api/connections"); http.setRequestHeader("Accept", "application/json"); http.setRequestHeader("Content-type", "application/json; charset=utf-8"); http.setRequestHeader("Content-length", params.length); 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); } } http.send(params); </script>
Παράδειγμα κλήσης της μεθόδου με PHP :
<?php header("Content-Type: text/html; charset=utf-8"); $params = array("connection_id" => "100"); $curl = curl_init("https://mm.sch.gr/api/connections"); curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); curl_setopt($curl, CURLOPT_USERPWD, "username:password"); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, "DELETE"); curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode( $params )); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $data = curl_exec($curl); $data = json_decode($data); echo "<pre>"; var_dump( $data ); echo "</pre>"; ?>
Πίνακας Δεδομένων
Παρακάτω εμφανίζεται πίνακας σε
μορφή JSON :
{
"method": "DeleteConnections",
"connection_id": 100,
"status": 200,
"message": "success"
}
integer |
$connection_id |
Κωδικός Διασύνδεσης Ο Κωδικός της Διασύνδεσης Η παράμετρος είναι υποχρεωτική Λίστα Τύπων Αναζήτησης : SearchEnumTypesΔιασυνδέσεις : GetConnections()Η τιμή της παραμέτρου μπορεί να είναι : integer
|
Array<JSON>
|
Επιστρέφει ένα πίνακα σε JSON μορφή με πεδία
: string : method : Η μέθοδος κλήσης της συνάρτησης integer : status : Ο Κωδικός ExceptionCodes του
αποτελέσματος της κλήσηςstring : message : Το Μήνυμα ExceptionMessages του
αποτελέσματος της κλήσηςinteger : connection_id : Ο Κωδικός της Διασύνδεσης |
Unauthorized
|
ExceptionMessages::UnauthorizedExceptionCodes::UnauthorizedΈλεγχος αν ο χρήστης υπάρχει και έχει δικαιώματα να χρησιμοποιείσει τη μέθοδο |
MissingConnectionIDParam
|
ExceptionMessages::MissingConnectionIDParamExceptionCodes::MissingConnectionIDParamΟ Κωδικός της Διασύνδεσης είναι υποχρεωτικό πεδίο |
MissingConnectionIDValue
|
ExceptionMessages::MissingConnectionIDValueExceptionCodes::MissingConnectionIDValueΟ Κωδικός της Διασύνδεσης πρέπει να έχει τιμή |
InvalidConnectionIDArray
|
ExceptionMessages::InvalidConnectionIDArrayExceptionCodes::InvalidConnectionIDArrayΟ Κωδικός της Διασύνδεσης δεν μπορεί να έχει πολλαπλές τιμές |
InvalidConnectionIDType
|
ExceptionMessages::InvalidConnectionIDTypeExceptionCodes::InvalidConnectionIDTypeΟ Κωδικός της Διασύνδεσης πρέπει να είναι αριθμητικός |
InvalidConnectionValue
|
ExceptionMessages::InvalidConnectionValueExceptionCodes::InvalidConnectionValueH Διασύνδεση δεν βρέθηκε |
UsedConnectionByUnitNetworkSubnets
|
ExceptionMessages::UsedConnectionByUnitNetworkSubnetsExceptionCodes::UsedConnectionByUnitNetworkSubnetsΗ Διασύνδεση Συσχετίζεται με Υποδικτύο της Μονάδας |