Για να δημιουργήσεις τη διεύθυνση URL της υπηρεσίας που θέλεις να χρησιμοποιήσεις, πρέπει να ακολουθήσεις την ακόλουθη δομή:

Βασική διεύθυνση URL που ομαδοποιεί τις υπηρεσίες Web:

στην οποία πρέπει να προσθέσεις, πρώτα απ' όλα, το τμήμα που υποδεικνύει την υπηρεσία στην οποία αναφέρεται και, στη συνέχεια, τις προαιρετικές παραμέτρους που καθορίζουν το συγκεκριμένο ερώτημά σου. Η πρώτη από αυτές πρέπει να ακολουθείται από ένα ερωτηματικό (?), ακολουθούμενο από ένα σύμβολο ίσον (=) και την τιμή της παραμέτρου. Από τη δεύτερη παράμετρο που πρέπει να προσθέσετε, θα πρέπει να χρησιμοποιήσετε το σύμβολο ampersand (&) αντί για το ερωτηματικό.

Παράδειγμα:

Δομή

Ο φάκελος

Κάθε απάντηση περιέχεται σε μια δομή που ονομάζεται envelope (φάκελος, περίβλημα). Αυτό σημαίνει ότι κάθε απάντηση έχει μια προκαθορισμένη δομή με την οποία μπορεί κανείς να αλληλεπιδράσει.

{
  "Service": "Όνομα υπηρεσίας",
  "Version": "Έκδοση υπηρεσίας",
  "TransactionId": "Αλφαριθμητικός αναγνωριστικός κωδικός συναλλαγής",
  "Status": {
    "Code": "Κωδικός απάντησης",
    "Value": "Τιμή απάντησης"
  },
  "Data": {}
}

Κατάσταση

Το κλειδί κατάσταση χρησιμοποιείται για τη λήψη πληροφοριών σχετικά με την απόκριση της υπηρεσίας. Εάν όλα έχουν εξελιχθεί κανονικά, η απόκριση θα αναγράφει στο χαρακτηριστικό Κωδικός η τιμή 200 ή 201. Ωστόσο, μπορεί να προκύψει κάποιο σφάλμα, οπότε η απάντηση που θα λάβετε θα είναι του είδους:

{
  "Status": {
    "Code": "401",
    "Value": "Μη εξουσιοδοτημένος"
  }
}

Αυθεντικοποίηση

Για τη χρήση των διαδικτυακών υπηρεσιών που διατίθενται σε αυτόν τον ιστότοπο, πρέπει να λάβετε υπόψη ότι η πιστοποίηση πρόσβασης είναι βασική και γι’ αυτό χρησιμοποιούνται τα διαπιστευτήρια API —όνομα χρήστη και κωδικός πρόσβασης— τα οποία λαμβάνετε μέσω του λογαριασμού σας στο MasterBase®.

Η χρήση αυτών εξαρτάται από τη γλώσσα που έχει επιλεγεί για τη χρήση των υπηρεσιών και αποτελεί ευθύνη του χρήστη.