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::MissingCircuitPhoneNumberValueExceptionCodes::MissingCircuitPhoneNumberValueΟ Αριθμός του Κυκλώματος πρέπει να έχει τιμή |
InvalidCircuitPhoneNumberArray
|
ExceptionMessages::InvalidCircuitPhoneNumberArrayExceptionCodes::InvalidCircuitPhoneNumberArrayΟ Αριθμός του Κυκλώματος δεν μπορεί να έχει πολλαπλές τιμές |
InvalidCircuitPhoneNumberType
|
ExceptionMessages::InvalidCircuitPhoneNumberTypeExceptionCodes::InvalidCircuitPhoneNumberTypeΟ Αριθμός του Κυκλώματος πρέπει να είναι αριθμητικός ή αλφαριθμητικός |
MissingCircuitPhoneNumberParam
|
ExceptionMessages::MissingCircuitPhoneNumberParamExceptionCodes::MissingCircuitPhoneNumberParamΟ Αριθμός του Κυκλώματος είναι υποχρεωτικό πεδίο |
DuplicatedCircuitValue
|
ExceptionMessages::DuplicatedCircuitValueExceptionCodes::DuplicatedCircuitValueΤο Τηλεπικοινωνιακό Κύκλωμα υπάρχει ήδη |
MissingUnitMMIDValue
|
ExceptionMessages::MissingUnitMMIDValueExceptionCodes::MissingUnitMMIDValueΟ Κωδικός ΜΜ πρέπει να έχει τιμή |
InvalidUnitMMIDArray
|
ExceptionMessages::InvalidUnitMMIDArrayExceptionCodes::InvalidUnitMMIDArrayΟ Κωδικός ΜΜ δεν μπορεί να έχει πολλαπλές τιμές |
InvalidUnitValue
|
ExceptionMessages::InvalidUnitValueExceptionCodes::InvalidUnitValueΗ Μονάδα δεν βρέθηκε |
InvalidUnitMMIDType
|
ExceptionMessages::InvalidUnitMMIDTypeExceptionCodes::InvalidUnitMMIDTypeΟ Κωδικός ΜΜ πρέπει να είναι αριθμητικός |
MissingUnitMMIDParam
|
ExceptionMessages::MissingUnitMMIDParamExceptionCodes::MissingUnitMMIDParamΟ Κωδικός ΜΜ είναι υποχρεωτικό πεδίο |
MissingCircuitTypeIDValue
|
ExceptionMessages::MissingCircuitTypeIDValueExceptionCodes::MissingCircuitTypeIDValueΟ Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος πρέπει να έχει τιμή |
InvalidCircuitTypeIDArray
|
ExceptionMessages::InvalidCircuitTypeIDArrayExceptionCodes::InvalidCircuitTypeIDArrayΟ Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος δεν μπορεί να έχει πολλαπλές τιμές |
InvalidCircuitTypeValue
|
ExceptionMessages::InvalidCircuitTypeValueExceptionCodes::InvalidCircuitTypeValueΟ Τύπος Τηλεπικοινωνιακού Κυκλώματος δεν υπάρχει στο λεξικό |
InvalidCircuitTypeIDType
|
ExceptionMessages::InvalidCircuitTypeIDTypeExceptionCodes::InvalidCircuitTypeIDTypeΟ Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι αριθμητικός |
MissingCircuitTypeIDParam
|
ExceptionMessages::MissingCircuitTypeIDParamExceptionCodes::MissingCircuitTypeIDParamΟ Κωδικός του Τύπου Τηλεπικοινωνιακού Κυκλώματος είναι υποχρεωτικό πεδίο |
InvalidCircuitStateType
|
ExceptionMessages::InvalidCircuitStateTypeExceptionCodes::InvalidCircuitStateTypeΗ Κατάσταση του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ενεργή ή Ανανεργή |
InvalidCircuitActivatedDateType
|
ExceptionMessages::InvalidCircuitActivatedDateTypeExceptionCodes::InvalidCircuitActivatedDateTypeΗ Ημερομηνία Ενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitUpdatedDateType
|
ExceptionMessages::InvalidCircuitUpdatedDateTypeExceptionCodes::InvalidCircuitUpdatedDateTypeΗ Ημερομηνία Ενημέρωσης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitDeactivatedDateType
|
ExceptionMessages::InvalidCircuitDeactivatedDateTypeExceptionCodes::InvalidCircuitDeactivatedDateTypeΗ Ημερομηνία Απενεργοποίησης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναι Ημερομηνία (dd/mm/yyyy) |
InvalidCircuitBandwidthType
|
ExceptionMessages::InvalidCircuitBandwidthTypeExceptionCodes::InvalidCircuitBandwidthTypeΤο Εύρως Ζώνης του Τηλεπικοινωνιακού Κυκλώματος πρέπει να αλφαριθμητικό |
InvalidCircuitReadspeedhType
|
ExceptionMessages::InvalidCircuitReadspeedhTypeExceptionCodes::InvalidCircuitReadspeedhTypeΗ Ταχύτητα του Τηλεπικοινωνιακού Κυκλώματος πρέπει να είναιαλφαριθμητική |
InvalidCircuitPaidByPsdType
|
ExceptionMessages::InvalidCircuitPaidByPsdTypeExceptionCodes::InvalidCircuitPaidByPsdTypeΗ Χρηματοδήτηση του Τηλεπικοινωνιακού Κυκλώματος από το ΠΣΔ πρέπει να είναι Ενεργή ή Ανανεργή |