Πριν ξεκινήσετε να χρησιμοποιείτε το API, πρέπει να αυθεντικοποιηθείτε για να δημιουργήσετε μια συνεδρία.
Αυθεντικοποίηση:
Υπάρχουν 2 τρόποι για να ξεκινήσετε τη συνεδρία:
- Χρησιμοποιώντας το κλειδί API σας, το όνομα χρήστη και τον κωδικό πρόσβασης.
- Χρησιμοποιώντας το κλειδί API σας, το όνομα χρήστη και τον κρυπτογραφημένο κωδικό πρόσβασης.
Χρησιμοποιώντας το κλειδί API σας, το όνομα χρήστη και τον κωδικό πρόσβασης
Εδώ απλά πρέπει να χρησιμοποιήσετε το endpoint POST /session και να αναφέρετε το κλειδί API που λάβατε από τις Ρυθμίσεις της πλατφόρμας στο header X-CAP-API-KEY, καθώς και τα στοιχεία του ονόματος χρήστη και του κωδικού πρόσβασης του API στα πεδία identifier και password. Η τιμή της παραμέτρου encryptedPassword πρέπει να είναι false.
Χρησιμοποιώντας το κλειδί API σας, το όνομα χρήστη και τον κρυπτογραφημένο κωδικό πρόσβασης
- Πρώτα πρέπει να χρησιμοποιήσετε το GET /session/encryptionKey και να αναφέρετε το κλειδί API που δημιουργήθηκε στις Ρυθμίσεις της πλατφόρμας στο header X-CAP-API-KEY. Στην απάντηση θα λάβετε τις παραμέτρους encryptionKey και timeStamp.
- Χρησιμοποιώντας τις παραμέτρους encryptionKey και timeStamp που λάβατε, πρέπει να κρυπτογραφήσετε τον κωδικό πρόσβασης του API σας χρησιμοποιώντας τη μέθοδο κρυπτογράφησης AES.
- Μεταβείτε στο endpoint POST /session, ορίστε την τιμή true για την παράμετρο encryptedPassword και αναφέρετε το κλειδί API που λάβατε από τις Ρυθμίσεις της πλατφόρμας στο header X-CAP-API-KEY, το όνομα χρήστη και τον προηγουμένως κρυπτογραφημένο κωδικό πρόσβασης του API στα πεδία identifier και password.
Με την έναρξη της συνεδρίας θα λάβετε τις παραμέτρους CST και X-SECURITY-TOKEN στα headers της απάντησης. Και τα δύο αυτά tokens πρέπει να χρησιμοποιούνται στα headers κάθε αιτήματος που στέλνετε.