API tarota
Ten endpoint wykonuje zalążkowane, odtwarzalne losowanie z 78-kartowej talii Rider-Waite-Smith dla rozkładu trzech kart. Zwraca metadane rozkładu, całkowity ziarno (seed) sterujące tasowaniem oraz wylosowane karty wraz z ich pozycjami, orientacjami i znaczeniami — tak że każdy odczyt można odtworzyć dokładnie, przekazując ziarno z powrotem.
API tarota
Mając opcjonalne pytanie i opcjonalne ziarno, endpoint losuje karty z pełnej 78-kartowej talii dla układu trzech kart, z każdą kartą lądującą w określonej pozycji i zorientowaną w pozycji prostej lub odwróconej. Odpowiedź opisuje sam rozkład, odzwierciedla użyte całkowite ziarno i wymienia wylosowane karty — każda niosąca swoją etykietę pozycji, orientację i znaczenie przypisane tej karcie w tej orientacji. Ziarno jest sercem konstrukcji: pomiń je, a serwer wygeneruje je za ciebie i zwróci; podaj je, a odtworzysz identyczne losowanie, co czyni odczyty udostępnialnymi, testowalnymi i audytowalnymi. Flaga allowReversed decyduje, czy odwrócenia są w ogóle możliwe. Inne rozkłady — pojedyncza karta, Krzyż Celtycki, podkowa, relacja i rok przed tobą — to endpointy siostrzane napędzane tą samą talią i mechanizmem ziaren.
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": "…"
}
]
}
}Parametry
| name | type | Wymagane | |
|---|---|---|---|
| question | string | nie | 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 | nie | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | nie | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
Kiedy używać
Sięgnij po to, gdy chcesz odczytu tarota, który możesz odtworzyć na żądanie, a nie jednorazowego losowania. Przechwyć zwrócone ziarno, a będziesz mógł ponownie wyrenderować dokładnie te same trzy karty później — w udostępnionym linku, zapisanym odczycie, teście regresji lub zgłoszeniu wsparcia — bez przechowywania listy kart samemu. Użyj stałego ziarna w testach, aby twój interfejs i tekst renderowały się deterministycznie, a w produkcji pozwól serwerowi wybić świeże ziarno dla prawdziwej różnorodności. Sięgnij po rozkład trzech kart konkretnie wtedy, gdy chcesz zwartej struktury w stylu przeszłość/teraźniejszość/przyszłość; przełącz się na endpoint siostrzany, gdy układ z większą liczbą pozycji lepiej pasuje do doświadczenia.
Uwagi
Obrazy kart to talia Rider-Waite-Smith (A. E. Waite i Pamela Colman Smith, 1909), która jest w domenie publicznej. Ustaw allowReversed na false, aby losować wyłącznie karty proste — przydatne dla przyjaznych początkującym odczytów, gdzie znaczenia odwrócone dodawałyby zamętu. To samo ziarno odtwarza losowanie tylko dla tego samego rozkładu i tego samego ustawienia allowReversed.
Wypróbuj API Rozkład trzech kart
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.