Function PostCircuits
Καταχώρηση Τηλεπικοινωνιακών Κυκλωμάτων
Η συνάρτηση αυτή καταχωρεί Τηλεπικοινωνιακά Κυκλώματα σύμφωνα με τις παραμέτρους που έγινε η κλήση
Η κλήση μπορεί να γίνει μέσω της παρακάτω
διεύθυνσης με τη μέθοδο POST :
https://mm.sch.gr/api/circuits
Πίνακας Παραμέτρων
Στον Πίνακα Παραμέτρων Parameters
summary εμφανίζονται όλοι οι παράμετροι με
τους οποίους μπορεί να γίνει η κλήση της
συνάρτησης
Όλοι οι παράμετροι είναι προαιρετικοί
εκτός από αυτές που έχουν χαρακτηριστεί ως
υποχρεωτικοί
Οι παράμετροι μπορούν να χρησιμοποιηθούν
με οποιαδήποτε σειρά
Πίνακας Αποτελεσμάτων
Στον Πίνακα Αποτελεσμάτων Return value
summary εμφανίζονται οι μεταβλητές που
επιστρέφει η συνάρτηση
Όλες οι μεταβλητές επιστρέφονται σε ένα
πίνακα σε JSON μορφή
Η μεταβλητή data είναι ο πίνακας με το
λεξικό
Η μεταβλητή status καθορίζει αν η εκτέλεση της
συνάρτησης ήταν επιτυχής (κωδικός 200) ή
προέκυψε κάποιο σφάλμα
Πίνακας Σφαλμάτων
Στον Πίνακα Σφαλμάτων Thrown exceptions
summary εμφανίζονται τα Μηνύματα Σφαλμάτων
που μπορεί να προκύψουν κατά την κλήση της
συνάρτησης
Οι περιγραφές των Σφαλμάτων καθώς και οι
Κωδικοί τους είναι διαθέσιμες μέσω του
πίνακα Μηνύματα Σφαλμάτων (ExceptionMessages
)
και Κωδικοί Σφαλμάτων (ExceptionCodes
)
αντίστοιχα
Παραδείγματα Κλήσης
Παρακάτω εμφανίζεται μια σειρά από
παραδείγματα κλήσης της συνάρτησης με
διάφορους τρόπους :
cURL | JavaScript | PHP | Ajax
Παράδειγμα κλήσης της συνάρτησης με cURL (console) :
curl -X POST https://mm.sch.gr/api/circuits \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -u username:password \ -d '{"circuit_type_id" : "2", \ "phone_number" : "value", \ "status" : "TRUE", \ "activated_date" : "2003-06-01 16:08:00", \ "mm_id" : "1013390", \ "paid_by_psd" : "TRUE", \ "updated_date" : "2013-12-18 16:08:00", \ "deactivated_date" : "null", \ "bandwidth" : "24576/1024Kbps", \ "readspeed" : "null" }'
Παράδειγμα κλήσης της συνάρτησης με JavaScript :
<script> var params = JSON.stringify({ "circuit_type_id" : "2", "phone_number" : "value", "status" : "TRUE", "activated_date" : "2003-06-01 16:08:00", "mm_id" : "1013390", "paid_by_psd" : "TRUE", "updated_date" : "2013-12-18 16:08:00", "deactivated_date" : "null", "bandwidth" : "24576/1024Kbps", "readspeed" : "null" }); var http = new XMLHttpRequest(); http.open("POST", "https://mm.sch.gr/api/circuits"); http.setRequestHeader("Accept", "application/json"); http.setRequestHeader("Content-type", "application/json; charset=utf-8"); http.setRequestHeader("Content-length", params.length); http.onreadystatechange = function() { if(http.readyState == 4 && http.status == 200) { alert(http.responseText); } } http.send(params); </script>
Παράδειγμα κλήσης της συνάρτησης με PHP :
<?php header("Content-Type: text/html; charset=utf-8"); $params = array( "circuit_type_id" => "2", "phone_number" => "value", "status" => "TRUE", "activated_date" => "2003-06-01 16:08:00", "mm_id" => "1013390", "paid_by_psd" => "TRUE", "updated_date" => "2013-12-18 16:08:00", "deactivated_date" => "null", "bandwidth" => "24576/1024Kbps", "readspeed" => "null" ); $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, "POST"); curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode( $params )); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $data = json_decode( curl_exec($curl) ); echo "<pre>"; var_dump( $data ); echo "</pre>"; ?>
Παράδειγμα κλήσης της συνάρτησης με Ajax :
<script> $.ajax({ type: 'POST', url: 'https://mm.sch.gr/api/circuits', dataType: "json", data: { "circuit_type_id" : "2", "phone_number" : "value", "status" : "TRUE", "activated_date" : "2003-06-01 16:08:00", "mm_id" : "1013390", "paid_by_psd" : "TRUE", "updated_date" : "2013-12-18 16:08:00", "deactivated_date" : "null", "bandwidth" : "24576/1024Kbps", "readspeed" : "null" }, beforeSend: function(req) { req.setRequestHeader('Authorization', btoa('username' + ":" + 'password')); }, success: function(data){ console.log(data); } }); </script>
Πίνακας Δεδομένων
Παρακάτω εμφανίζεται πίνακας σε
μορφή JSON :
{ "method": "PostCircuits", "circuit_id": "10650", "status": 200, "message": "success" }
integer |
$mm_id |
Κωδικός ΜΜ Μονάδας Ο Κωδικός ΜΜ της Μονάδας Η παράμετρος είναι υποχρεωτική Μονάδες : GetUnits() Η τιμή της παραμέτρου μπορεί να είναι : integer
|
integer |
$circuit_type_id |
Κωδικός Τύπου Κυκλώματος Ο Κωδικός του Τύπου του Τηλεπικοινωνιακού Κυκλώματος Η παράμετρος είναι υποχρεωτική Τύποι Τηλεπικοινωνιακών Κυκλωμάτων : GetCircuitTypes() Η τιμή της παραμέτρου μπορεί να είναι : integer
|
string |
$phone_number |
Τηλεφωνικός Αριθμός Ο Τηλεφωνικός Αριθμός του Τηλεπικοινωνιακού Κυκλώματος |
boolean |
$status |
Ενεργό/Ανενεργό Η Κατάσταση του Τηλεπικοινωνιακού Κυκλώματος |
datetime |
$activated_date |
Ημερομηνία Ενεργοποίησης Η Ημερομηνία Ενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος |
datetime |
$updated_date |
Ημερομηνία Ενημέρωσης Η Ημερομηνία Ενημέρωσης του Τηλεπικοινωνιακού Κυκλώματος |
datetime |
$deactivated_date |
Ημερομηνία Απενεργοποίησης Η Ημερομηνία Απενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος |
string |
$bandwidth |
Εύρως Ζώνης Το Εύρως Ζώνης του Τηλεπικοινωνιακού Κυκλώματος |
string |
$readspeed |
Ταχύτητα Η Ταχύτητα του Τηλεπικοινωνιακού Κυκλώματος |
boolean |
$paid_by_psd |
Χρηματοδοτείται από το ΠΣΔ Το Τηλεπικοινωνιακό Κύκλωμα Χρηματοδοτείται από το ΠΣΔ |
Array<JSON>
|
Επιστρέφει ένα πίνακα σε JSON μορφή με πεδία
:
|
MissingCircuitPhoneNumberValue
|
ExceptionMessages::MissingCircuitPhoneNumberValue ExceptionCodes::MissingCircuitPhoneNumberValue Ο Αριθμός του Κυκλώματος πρέπει να έχει τιμή |
InvalidCircuitPhoneNumberArray
|
ExceptionMessages::InvalidCircuitPhoneNumberArray ExceptionCodes::InvalidCircuitPhoneNumberArray Ο Αριθμός του Κυκλώματος δεν μπορεί να έχει πολλαπλές τιμές |
InvalidCircuitPhoneNumberType
|
ExceptionMessages::InvalidCircuitPhoneNumberType ExceptionCodes::InvalidCircuitPhoneNumberType Ο Αριθμός του Κυκλώματος πρέπει να είναι αριθμητικός ή αλφαριθμητικός |
MissingCircuitPhoneNumberParam
|
ExceptionMessages::MissingCircuitPhoneNumberParam ExceptionCodes::MissingCircuitPhoneNumberParam Ο Αριθμός του Κυκλώματος είναι υποχρεωτικό πεδίο |
DuplicatedCircuitValue
|
ExceptionMessages::DuplicatedCircuitValue ExceptionCodes::DuplicatedCircuitValue Το Τηλεπικοινωνιακό Κύκλωμα υπάρχει ήδη |
MissingUnitMMIDValue
|
ExceptionMessages::MissingUnitMMIDValue ExceptionCodes::MissingUnitMMIDValue Ο Κωδικός ΜΜ πρέπει να έχει τιμή |
InvalidUnitMMIDArray
|
ExceptionMessages::InvalidUnitMMIDArray ExceptionCodes::InvalidUnitMMIDArray Ο Κωδικός ΜΜ δεν μπορεί να έχει πολλαπλές τιμές |
InvalidUnitValue
|
ExceptionMessages::InvalidUnitValue ExceptionCodes::InvalidUnitValue Η Μονάδα δεν βρέθηκε |
InvalidUnitMMIDType
|
ExceptionMessages::InvalidUnitMMIDType ExceptionCodes::InvalidUnitMMIDType Ο Κωδικός ΜΜ πρέπει να είναι αριθμητικός |
MissingUnitMMIDParam
|
ExceptionMessages::MissingUnitMMIDParam ExceptionCodes::MissingUnitMMIDParam Ο Κωδικός ΜΜ είναι υποχρεωτικό πεδίο |
MissingCircuitTypeIDValue
|
ExceptionMessages::MissingCircuitTypeIDValue ExceptionCodes::MissingCircuitTypeIDValue Ο Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος πρέπει να έχει τιμή |
InvalidCircuitTypeIDArray
|
ExceptionMessages::InvalidCircuitTypeIDArray ExceptionCodes::InvalidCircuitTypeIDArray Ο Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος δεν μπορεί να έχει πολλαπλές τιμές |
InvalidCircuitTypeValue
|
ExceptionMessages::InvalidCircuitTypeValue ExceptionCodes::InvalidCircuitTypeValue Ο Τύπος Τηλεπικοινωνιακού Κυκλώματος δεν υπάρχει στο λεξικό |
InvalidCircuitTypeIDType
|
ExceptionMessages::InvalidCircuitTypeIDType ExceptionCodes::InvalidCircuitTypeIDType Ο Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι αριθμητικός |
MissingCircuitTypeIDParam
|
ExceptionMessages::MissingCircuitTypeIDParam ExceptionCodes::MissingCircuitTypeIDParam Ο Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος είναι υποχρεωτικό πεδίο |
InvalidCircuitStateType
|
ExceptionMessages::InvalidCircuitStateType ExceptionCodes::InvalidCircuitStateType Η Κατάσταση του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ενεργή ή Ανανεργή |
InvalidCircuitActivatedDateType
|
ExceptionMessages::InvalidCircuitActivatedDateType ExceptionCodes::InvalidCircuitActivatedDateType Η Ημερομηνία Ενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitUpdatedDateType
|
ExceptionMessages::InvalidCircuitUpdatedDateType ExceptionCodes::InvalidCircuitUpdatedDateType Η Ημερομηνία Ενημέρωσης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitDeactivatedDateType
|
ExceptionMessages::InvalidCircuitDeactivatedDateType ExceptionCodes::InvalidCircuitDeactivatedDateType Η Ημερομηνία Απενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitBandwidthType
|
ExceptionMessages::InvalidCircuitBandwidthType ExceptionCodes::InvalidCircuitBandwidthType Το Εύρως Ζώνης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να αλφαριθμητικό |
InvalidCircuitReadspeedhType
|
ExceptionMessages::InvalidCircuitReadspeedhType ExceptionCodes::InvalidCircuitReadspeedhType Η Ταχύτητα του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναιαλφαριθμητική |
InvalidCircuitPaidByPsdType
|
ExceptionMessages::InvalidCircuitPaidByPsdType ExceptionCodes::InvalidCircuitPaidByPsdType Η Χρηματοδήτηση του Τηλεπικοινωνιακού Κυκλώματος από το ΠΣΔ πρέπει να είναι Ενεργή ή Ανανεργή |