Tarot API
Tento endpoint provede náhodně generovaný, reprodukovatelný výsledek tříkarty pro rozložení 78 karet z karet Rider-Waite-Smith. Vrací metadata rozložení, celočíselný seed, který ovlivnil míchání, a karty s jejich pozicemi, orientacemi a významy - tak jakékoli čtení lze zopakovat přesně tím, že se seed vrátíte.
Tarot API
S možným dotazem a možným seedem vrátí endpoint karty z plné 78karty pro tříkarty rozložení, kde každá karta dopadne v definovaném místě a může být orientována vzhůru nebo vzhůru nohama. Odpověď popisuje rozložení samotné, echoval seed použité a seznam karet - každá karta nesoucí své pozice označení, orientaci a význam, který je připojen k té karte v té orientaci. Seed je srdcem návrhu: vynechte ho a server vygeneruje jeden pro vás a vrátí ho; dodávejte ho a vyregenerujete stejný výsledek, který činí čtení sdílenými, testovatelnými a ověřitelnými. PovolenoReversed flag rozhoduje, zda jsou možné převrácení vůbec.
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
Dostupný, když chcete tarot čtení, které můžete reprodukovat na vyžádání místo náhodného výslehu. Uchopte vrácený seed a můžete re-renderovat stejný výsledek později - v sdíleném odkazu, uloženém čtení, regresním testu nebo podpořte ticketu - bez ukládání seznamu karet sami. Používejte pevný seed v testech tak, aby vaše UI a kopírování byly deterministické, a dejte serveru vygenerovat nový seed v produkci pro skutečnou rozmanitost. Dostupný, když chcete kompaktní strukturu minulé/dnešního/zakázané stylu; přepněte se na sesterský endpoint, když layout s více pozicemi vyhovuje lepšímu zážitku.
Notes
Obraz karet je karty Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), který je ve veřejném doméně. Nastavte allowReversed na false, aby se karty vynořily pouze vzhůru - užitečné pro čtení začátečníkům, kde by se převrácené významy přidaly zmatek. Stejný seed reprodukuje výsledek pouze pro stejný rozložení a stejný nastavení allowReversed.
Try the Three-Card Draw API
Grab a key and make your first call in under a minute.