Προγραμματιστές

GET/v3/documents

Λίστα προφίλ καταχώρισης

Βρείτε τα ενεργά τοπικά προφίλ του λογαριασμού με το περιορισμένο σύνολο πεδίων της παλαιότερης υλοποίησης.

Σε αυτή τη σελίδα
  1. Βρείτε υπάρχοντα προφίλ καταχώρισης
  2. Αίτημα λίστας
  3. Λίστα απόκρισης
  4. Πεδία προφίλ που επιστρέφονται
  5. Επόμενα βήματα

Βρείτε υπάρχοντα προφίλ καταχώρισης

Δείτε τη λίστα των ενεργών τοπικών προφίλ καταχώρισης που δεν έχουν διαγραφεί και συνδέονται με τον λογαριασμό σας στο API. Χρησιμοποιήστε τη για να εντοπίσετε το UUID ενός προφίλ πριν το ανοίξετε με τη get_document, όχι για να διαπιστώσετε αν εγκρίθηκαν τα δικαιολογητικά του ή η καταχώριση του αριθμού.

Αίτημα λίστας

Πραγματοποιήστε έλεγχο ταυτότητας με τον ενεργοποιημένο λογαριασμό σας στο MultiTEL API και την επιτρεπόμενη διεύθυνση IP του. Τα παραδείγματα χρησιμοποιούν διαπιστευτήρια HTTP Basic αποθηκευμένα σε μεταβλητές περιβάλλοντος. Ελέγξτε τόσο την απόκριση HTTP όσο και το πεδίο JSON status.code· μια απόκριση HTTP 200 από μόνη της δεν επιβεβαιώνει την επιτυχία. Όλες οι τιμές των παραδειγμάτων είναι πλασματικές.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

Αυτός ο χειριστής δεν υλοποιεί σώμα αιτήματος, σελιδοποίηση ή παραμέτρους φιλτραρίσματος. Επιστρέφει τα αποθηκευμένα προφίλ του αντίστοιχου λογαριασμού· μην θεωρείτε δεδομένη κάποια συγκεκριμένη σειρά. Αποφύγετε τη συχνή περιοδική ανάκτηση ολόκληρης της λίστας για μεγάλους λογαριασμούς.

Λίστα απόκρισης

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

Αν δεν υπάρχουν αντίστοιχα ενεργά προφίλ, ο χειριστής επιστρέφει κωδικό API 200 και κενή λίστα απόκρισης. Το response[].id είναι το UUID του τοπικού προφίλ που επιστρέφεται ως uuid κατά τη δημιουργία· δεν είναι αναγνωριστικό ταυτότητας ή διεύθυνσης.

Πεδία προφίλ που επιστρέφονται

Το σύνολο πεδίων που επιστρέφεται περιλαμβάνει τα id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature και date_created.

Οι προαιρετικές τιμές μπορεί να είναι κενές ή null, ανάλογα με τα αποθηκευμένα δεδομένα. Αυτό το σύνολο πεδίων της παλαιότερης υλοποίησης παραλείπει το email, τα πεδία επιλογής χώρας, το identity_id, το address_id, τις αναφορές σε μεταφορτωμένα αρχεία, τις λίστες δικαιολογητικών και την κατάσταση επαλήθευσης. Δεν είναι τελικό σημείο για την κατάσταση δικαιολογητικών ή την έγκριση καταχώρισης. Αντιμετωπίστε τα δεδομένα ταυτότητας, επικοινωνίας και υπογραφής που επιστρέφονται ως ιδιωτικά.

Επόμενα βήματα

Αποθηκεύστε τα αναγνωριστικά οντοτήτων από την αρχική απόκριση της create_document για μεταγενέστερες επισυνάψεις. Αν χάθηκε εκείνη η απόκριση, αυτή η λίστα δεν μπορεί να ανακτήσει τα αναγνωριστικά. Εξετάστε το προφίλ στη διαδικτυακή πύλη ή επικοινωνήστε με την υποστήριξη αντί να δημιουργήσετε αυτόματα ένα διπλότυπο.