Μετάβαση από την Beta

Αυτό το άρθρο απευθύνεται σε Οργανισμούς που δημιουργήθηκαν με το μοντέλο πρόσβασης Beta, όπου ένας διαχειριστής χορήγησε δικαιώματα σε κάθε Μέλος ξεχωριστά. Η πρόσβαση πλέον βασίζεται σε Workflow Profiles και Account Roles, και η Kraken μετατρέπει τον Οργανισμό σας για εσάς.

Δύο πράγματα απαιτούν την προσοχή σας πριν από τη μετατροπή:

  • Εάν χρησιμοποιείτε κλειδιά API, οι ενσωματώσεις σας πρέπει να ενημερωθούν πρώτα. Ο τρόπος με τον οποίο οι αιτήσεις επιλέγουν έναν λογαριασμό έχει αλλάξει και μια επιτυχής κλήση ανάληψης δεν σημαίνει πλέον ότι τα κεφάλαια έχουν μετακινηθεί. Δείτε «Ενημέρωση των ενσωματώσεων API σας» παρακάτω.
  • Θα σας ζητήσουμε να επιβεβαιώσετε ότι είστε έτοιμοι. Ο Οργανισμός σας δεν μετατρέπεται μέχρι να αποδεχτείτε την αλλαγή.

Τίποτα στη μετατροπή δεν καταργεί την πρόσβαση. Κάθε δικαίωμα που κατείχε κάθε Μέλος μεταφέρεται.

Τα υπάρχοντα κλειδιά API σας δεν ανακαλούνται ούτε επανεκδίδονται. Τα διαπιστευτήρια, τα δικαιώματα και η αντιστοίχιση λογαριασμού μεταφέρονται όλα. Αυτό που αλλάζει είναι ο τρόπος με τον οποίο ο κώδικάς σας χειρίζεται τις αιτήσεις και διαβάζει τις αποκρίσεις.

Επιλέξτε έναν λογαριασμό σε κάθε αίτηση

Ένα κλειδί API Οργανισμού καλύπτει έναν ή περισσότερους Λογαριασμούς και δεν έχει προεπιλογή, οπότε κάθε ιδιωτική αίτηση πρέπει να αναφέρει σε ποιον Λογαριασμό εφαρμόζεται. Περάστε το account_id ως παράμετρο ερωτήματος στη διεύθυνση URL, όχι στο σώμα της αίτησης:

bash

Bash

POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYH

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

Προσοχή:

Δοκιμάστε κάθε διαδρομή κλήσης σε περιβάλλον μη παραγωγής πριν μεταβείτε, συμπεριλαμβανομένων αυτών που δεν περιμένετε να έχουν αλλάξει. Μια ιδιωτική αίτηση που παραλείπει το account_id ενδέχεται να επιστρέψει ένα επιτυχές αλλά κενό αποτέλεσμα αντί για σφάλμα, το οποίο μπορεί εύκολα να παρερμηνευθεί ως Λογαριασμός χωρίς δραστηριότητα.

Διαβάστε τη νέα απόκριση ανάληψης

Το WithdrawFunds επιστρέφει το approval_request_id μαζί με το refid:

bash

Bash

{
  "error": [],
  "result": {
    "refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
    "approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
  }
}
  • Ένα refid δεν σημαίνει πλέον ότι η ανάληψη ολοκληρώθηκε. Το ποσό κλειδώνεται στον λογαριασμό προέλευσης όταν υποβάλλεται η αίτηση και εκκαθαρίζεται μόνο μετά την έγκριση της αίτησης.
  • Το approval_request_id είναι το αναγνωριστικό για την έγκριση που περιμένει η ανάληψη. Αποθηκεύστε το στα δικά σας αρχεία.
  • Οι αναλήψεις που αναμένουν έγκριση δεν εμφανίζονται στο WithdrawStatus. Μια αίτηση που απορρίπτεται ή λήγει δεν δημιουργεί καθόλου εγγραφή ανάληψης, οπότε η απουσία από το WithdrawStatus δεν σημαίνει ποτέ ότι μια ανάληψη δεν υποβλήθηκε.

Η αυτοματοποίηση που αντιμετωπίζει ένα refid ως απόδειξη ολοκλήρωσης θα αναφέρει τις αναλήψεις ως διευθετημένες ενώ βρίσκονται ακόμη στην ουρά έγκρισης. Δείτε τα κλειδιά API για το πλήρες μοντέλο.

Ο Οργανισμός σας βγαίνει από τη μετατροπή με δύο σύνολα τυποποιημένων δομικών στοιχείων.

Workflow Profiles

Ένα Workflow Profile καθορίζει τι μπορεί να κάνει ένα Μέλος σε κάθε διαχειριζόμενη ροή εργασιών. Κάθε Μέλος κατέχει ακριβώς ένα.

Προφίλ

Τι περιέχει

Admin

Κάθε επίπεδο σε κάθε ροή εργασιών, συμπεριλαμβανομένου του Execute

Initiator

Προβολή και Initiate σε κάθε ροή εργασιών. Δεν μπορεί να Approve

Approver

Προβολή και Approve σε κάθε ροή εργασιών. Δεν μπορεί να Initiate

Auditor

Προβολή σε κάθε ροή εργασιών. Δεν μπορεί να ενεργήσει

Funds Manager

Προβολή, Initiate και Approve σε Withdrawal Request και Transfer Request. Προβολή και Initiate σε Manage Addresses

Account Roles

Ένας Account Role καθορίζει τι μπορεί να κάνει ένα Μέλος στους Λογαριασμούς σας. Οι τυπικοί ρόλοι καλύπτουν όλους τους τρέχοντες και μελλοντικούς Λογαριασμούς, οπότε ένα Μέλος στο Trade all μπορεί να κάνει συναλλαγές σε έναν Λογαριασμό που θα δημιουργήσετε αύριο.

Ρόλος

Τι παρέχει σε κάθε Λογαριασμό

Ανάγνωση όλων

Ανάγνωση

Όλες οι συναλλαγές

Συναλλαγές

Όλα τα κεφάλαια

Μεταφορά, Ανάληψη, Διάθεση Εσόδων, Ανάκληση Διάθεσης Εσόδων

Πλήρης πρόσβαση

Κάθε δικαίωμα λογαριασμού

Τα τυπικά προφίλ και οι ρόλοι συμβαδίζουν με το προϊόν: όταν προστίθεται μια νέα ροή εργασιών, τα Μέλη που κατέχουν ένα αποκτούν αυτόματα το κατάλληλο επίπεδο. Δείτε τους Ρόλους, προφίλ και δικαιώματα για το πλήρες μοντέλο.

Όπου τα δικαιώματα ενός Μέλους δεν αντιστοιχούν σε κανένα τυπικό προφίλ, τοποθετούνται σε έναν ρόλο που περιλαμβάνει ακριβώς όσα είχαν. Τα Μέλη με πανομοιότυπα δικαιώματα μοιράζονται έναν ενιαίο ρόλο, οπότε ο Οργανισμός σας θα έχει πολύ λιγότερους ρόλους από τα Μέλη.

Αυτοί οι ρόλοι λαμβάνουν το όνομά τους από την ετικέτα που είχατε γράψει δίπλα στο Μέλος, οπότε ένα Μέλος με την ετικέτα “Trader” καταλήγει σε έναν ρόλο που ονομάζεται trader. Τα Μέλη χωρίς ετικέτα καταλήγουν στο migrated-role. Κάθε ένας φέρει ένα σήμα μεταφερμένο, που σημαίνει ότι το όνομα δημιουργήθηκε αυτόματα και μπορείτε να το αλλάξετε.

Συμβουλή:

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

Γιατί τα Μέλη σας με τον ρόλο “Admin” δεν βρίσκονται στο προφίλ Admin

Η ετικέτα “Admin” της Beta επέτρεπε σε κάποιον να βλέπει, να ξεκινά και να εγκρίνει, αλλά όχι να ολοκληρώνει τα δικά του αιτήματα χωρίς δεύτερη έγκριση. Το προφίλ Admin περιλαμβάνει αυτή τη δυνατότητα, η οποία είναι το επίπεδο Εκτέλεσης.

Αντί να το εκχωρηθεί αυτόματα, τα Μέλη με την παλιά ετικέτα τοποθετούνται σε έναν ρόλο με όνομα beta-admin, ο οποίος περιλαμβάνει ακριβώς τα δικαιώματα που είχαν ήδη. Η μετακίνησή τους στο Admin είναι μια ενιαία ανάθεση όποτε αποφασίσετε να το κάνετε.

Σημείωση:

Το beta-admin είναι ένας από τους δικούς σας ρόλους, οπότε τα Μέλη που το κατέχουν δεν θα αποκτούν αυτόματα νέες ροές εργασιών όπως συμβαίνει με τα τυπικά προφίλ. Αυτός είναι ένας ακόμη λόγος για να αναθεωρήσετε αυτούς τους ρόλους αμέσως μετά τη μετατροπή.

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

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

  • Κάθε δικαίωμα που κατείχε κάθε Μέλος μεταφέρεται.
  • Οι διαπιστευτήρια κλειδιού API, τα δικαιώματα και η αντιστοίχιση Λογαριασμών διατηρούνται.
  • Τα υπόλοιπα, οι Λογαριασμοί και η ιδιοκτησία Λογαριασμών παραμένουν ανέγγιχτα.
  • Τα αιτήματα έγκρισης που βρίσκονται ήδη σε εξέλιξη συνεχίζονται, και οι πολιτικές σας, τα όρια έγκρισης και οι ρυθμίσεις "πάντα να απαιτείται έγκριση" παραμένουν αμετάβλητα.
  • Η επαλήθευση ταυτότητας δεν επηρεάζεται, και κανείς δεν χρειάζεται να συνδεθεί ξανά ή να προσκληθεί εκ νέου.
  • Μόνο οι Λογαριασμοί που ανήκουν στον Οργανισμό σας μετατρέπονται. Ένα δικαίωμα σε οποιονδήποτε Λογαριασμό εκτός αυτού παραμένει ως έχει.

Αντιμετώπιση προβλημάτων

Το αίτημα σχεδόν σίγουρα λείπει από το account_id. Χωρίς αυτό, μια ιδιωτική κλήση δεν επιλύεται σε έναν από τους Λογαριασμούς του κλειδιού και μπορεί να απαντήσει με ένα κενό αποτέλεσμα αντί για ένα σφάλμα. Προσθέστε το account_id στο URL και επανελέγξτε κάθε τελικό σημείο που καλεί η ενσωμάτωσή σας, όχι μόνο αυτά που απέτυχαν εμφανώς. Ανατρέξτε στο API keys.

Η κλήση δημιούργησε ένα αίτημα και κλείδωσε το ποσό στον Λογαριασμό πηγής. Η εκκαθάριση ακολουθεί την έγκριση. Παρακολουθήστε το αίτημα με το approval_request_id που επιστρέφεται από την κλήση, ή βρείτε το στη σελίδα Αιτημάτων. Ανατρέξτε στο Μεταφορές και αναλήψεις.

Μέλη των οποίων οι άδειες δεν ταίριαζαν με ένα τυπικό προφίλ, το καθένα χρειάζεται έναν ρόλο που διατηρεί την πρόσβασή του, και δύο Μέλη συγχωνεύονται σε έναν ρόλο μόνο όταν οι άδειές τους είναι πανομοιότυπες. Μέλη στα οποία είχατε δώσει διαφορετικές ετικέτες παραμένουν σε ξεχωριστούς ρόλους ακόμη και όταν οι άδειές τους ταιριάζουν, επειδή οι ετικέτες υποδηλώνουν ότι η διάκριση ήταν σκόπιμη. Ρόλοι που δεν χρειάζεστε μπορούν να ενοποιηθούν αναθέτοντας εκ νέου τα Μέλη τους και διαγράφοντας τον κενό ρόλο.

Μέλη που διαχειρίζονται τον Οργανισμό, διαχειρίζονται την πρόσβαση ομάδας, τους Λογαριασμούς ή τα API keys, τοποθετούνται στο Read all, επειδή η διαχείριση ενός Λογαριασμού συνεπάγεται τη δυνατότητα προβολής του. Εάν αυτό είναι ευρύτερο από ό,τι επιθυμείτε, αντικαταστήστε το Read all με έναν Ρόλο Λογαριασμού που περιορίζεται στους συγκεκριμένους Λογαριασμούς που χρειάζονται.

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

Σχετικά άρθρα

Χρειάζεστε περισσότερη βοήθεια;