Tarot API
Αυτό το endpoint εκτελεί μια ενσπείρωση, αναπαραγώγιμη κλήρωση από την τράπουλα 78 καρτών Rider-Waite-Smith για το spread τριών καρτών. Σου επιστρέφει τα μεταδεδομένα του spread, το ακέραιο seed που καθόριζε την ανάμιξη, και τις κλημένες κάρτες με τις θέσεις, τους προσανατολισμούς και τις σημασίες τους - ώστε να μπορείς να επαναλάβεις ακριβώς την ανάγνωση δίνοντας ξανά το seed.
Tarot API
Με μια προαιρετική ερώτηση και ένα προαιρετικό seed, το endpoint τραβάει κάρτες από την πλήρη τράπουλα 78 καρτών για τη διάταξη τριών καρτών, με κάθε κάρτα να τοποθετείται σε καθορισμένη θέση και να είναι είτε όρθια είτε ανάποδη. Η απάντηση περιγράφει το spread, επαναλαμβάνει το ακέραιο seed που χρησιμοποιήθηκε, και παραθέτει τις κλημένες κάρτες - καθεμία με την ετικέτα θέσης, τον προσανατολισμό της και τη σημασία της σε αυτόν τον προσανατολισμό. Το seed είναι η καρδιά του σχεδίου: αν το παραλείψεις, ο server δημιουργεί ένα για σένα και το επιστρέφει· αν το δώσεις, ξαναδημιουργείς την ίδια κλήρωση, κάνοντας τις αναγνώσεις διαμοιραζόμενες, δοκιμαστικές και ελεγχόμενες. Η σημαία allowReversed καθορίζει αν επιτρέπονται οι ανάστροφες. Άλλα spreads - μονή κάρτα, Celtic Cross, horseshoe, relationship και year-ahead - είναι συναφή endpoints που τροφοδοτούνται από την ίδια τράπουλα και μηχανισμό seed.
POST/v1/tarot/rider-waite/draw/three-card
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"question": "How will my new project unfold?"
}'{
"ok": true,
"data": {
"spread": {
"slug": "three-card",
"name": "Three Card",
"cardCount": 3
},
"seed": 4044793529,
"drawn": [
{
"position": {
"index": 0,
"name": "Past"
},
"card": {
"slug": "knight-of-wands",
"name": "Knight of Wands"
},
"reversed": false,
"meaning": "…"
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| question | string | no | An optional free-text question to associate with the reading; it is recorded with the draw but does not alter which cards are dealt. |
| seed | number | no | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | no | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
When to use it
Χρησιμοποίησέ το όταν θέλεις μια ανάγνωση ταρώ που μπορείς να επαναλάβεις όποτε θέλεις, αντί για μια τυχαία κλήρωση μίας φοράς. Κατέγραψε το seed που επιστρέφεται και μπορείς να ξανασχεδιάσεις τις ίδιες τρεις κάρτες αργότερα - σε κοινό σύνδεσμο, αποθηκευμένη ανάγνωση, regression test ή support ticket - χωρίς να αποθηκεύεις τη λίστα καρτών εσύ. Χρησιμοποίησε σταθερό seed στα tests ώστε το UI και το κείμενο σου να αποδίδουν σταθερά, και άσε τον server να δημιουργήσει νέο seed στην παραγωγή για πραγματική ποικιλία. Διάλεξε το spread τριών καρτών όταν θέλεις μια σύντομη δομή παρελθόν/παρόν/μέλλον· άλλαξε σε συναφή endpoint όταν μια διάταξη με περισσότερες θέσεις ταιριάζει καλύτερα στην εμπειρία.
Notes
Οι εικόνες των καρτών προέρχονται από την τράπουλα Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), η οποία είναι δημόσιο domain. Όρισε το allowReversed σε false για να τραβάς μόνο όρθιες κάρτες - χρήσιμο για αρχάριους, όπου οι ανάστροφες σημασίες θα προκαλούσαν σύγχυση. Το ίδιο seed επαναλαμβάνει την κλήρωση μόνο για το ίδιο spread και την ίδια ρύθμιση allowReversed.
Try the Τραβήξιμο τριών καρτών API
Grab a key and make your first call in under a minute.