Ανακτήστε το υπόλοιπο, το νόμισμα και την τιμή των όρων πληρωμής του λογαριασμού που αντιστοιχεί στα διαπιστευτήριά σας για το API. Πρόκειται για αναζήτηση υπολοίπου· δεν προσθέτει χρήματα ούτε υποβάλλει παραγγελία.
Αίτημα
Χρησιμοποιήστε διαπιστευτήρια API στην πλευρά του διακομιστή μέσω HTTPS. Τα παραδείγματα διαβάζουν διαπιστευτήρια από μεταβλητές περιβάλλοντος· δεν περιέχουν διαπιστευτήρια που μπορούν να χρησιμοποιηθούν για πρόσβαση. Ελέγξτε το status.code στο σώμα JSON, καθώς και την κατάσταση HTTP. Αυτοί οι παλαιότεροι χειριστές δεν ορίζουν με συνέπεια κατάσταση σφάλματος HTTP όταν παρουσιάζεται σφάλμα εφαρμογής.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/getbalance"Δεν απαιτούνται παράμετροι διαδρομής, ερωτήματος ή σώματος.
Απόκριση
Αυτό είναι ένα ενδεικτικό παράδειγμα της δομής της απόκρισης και δεν αποτελεί δεδομένα λογαριασμού ή τρέχουσα προσφορά τιμής.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"balance": "125.50",
"currency": "USD",
"terms": "prepaid"
}
}| Πεδίο | Σημασία |
|---|---|
balance | Το αποθηκευμένο υπόλοιπο του λογαριασμού. Διατηρείτε την ακρίβεια των δεκαδικών ψηφίων κατά την επεξεργασία χρηματικών τιμών. |
currency | Η τιμή του νομίσματος που είναι αποθηκευμένη για αυτόν τον λογαριασμό. |
terms | Η αποθηκευμένη τιμή των όρων πληρωμής του λογαριασμού. Ο χειριστής δεν απαριθμεί τις δυνατές τιμές ούτε κανονικοποιεί αυτήν την τιμή· μην θεωρείτε ότι το παράδειγμα καλύπτει όλες τις δυνατές τιμές. |
Σφάλματα και χρήση
Σε περίπτωση αποτυχίας ελέγχου ταυτότητας, χρησιμοποιείται η κοινή απόκριση ελέγχου ταυτότητας του API. Αυτός ο χειριστής δεν ορίζει ξεχωριστό σφάλμα για την απουσία υπολοίπου ούτε σελιδοποίηση. Το υπόλοιπο που επιστρέφεται δεν αποτελεί δέσμευση χρημάτων και δεν εγγυάται ότι μια μεταγενέστερη παραγγελία θα ολοκληρωθεί επιτυχώς.