Οδηγός ενσωμάτωσης του Housing Market API

Απόκτηση κλειδιού

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

1. Συνδεθείτε στην κονσόλα ή δημιουργήστε λογαριασμό. Είναι ο ίδιος λογαριασμός που χρησιμοποιείτε για άλλα προϊόντα Housing Market.
2. Επιλέξτε τις χώρες, μια περιοχή ή παγκόσμια κάλυψη, το πρόγραμμα και μηνιαία ή ετήσια χρέωση.
3. Εισαγάγετε τη διεύθυνση IP από την οποία οι διακομιστές σας θα καλούν το API.
4. Αποδεχτείτε τους όρους χρήσης του API. Τηρούμε αρχείο με το τι αποδεχτήκατε και πότε.
5. Πληρώστε. Το κλειδί σας εμφανίζεται μόνο αφού ολοκληρωθεί επιτυχώς η πληρωμή, και εμφανίζεται μία φορά.

Αντιγράψτε το κλειδί απευθείας στον χώρο αποθήκευσης μυστικών σας. Διατηρούμε μόνο έναν μονόδρομο κατακερματισμό (hash) του, οπότε δεν μπορούμε να σας το εμφανίσουμε ξανά. Ένα κλειδί έχει τη μορφή hma_<prefix>_<secret>.

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

Καταστάσεις κλειδιού

• Ενεργό: το κλειδί λειτουργεί.
• Σε παύση: το κλειδί απορρίπτεται με key_paused. Επανενεργοποιείται αυτόματα όταν επιλυθεί η αιτία.
• Ανακλήθηκε: το κλειδί απορρίπτεται οριστικά με unauthenticated.

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

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