Tarot API
Ez a végpont egy maggal ellátott, reprodukálható húzást végez a 78 lapos Rider-Waite-Smith pakliból a háromlapos elrendezéshez. Visszaadja az elrendezés metaadatait, a keverést vezérlő egész magot, és a húzott lapok pozícióit, orientációját és jelentését - így bármelyik olvasás pontosan visszajátszható a visszaküldött maggal.
Tarot API
Opcionális kérdés és opcionális mag mellett a végpont lapokat húz a teljes 78 lapos pakliból a háromlapos elrendezéshez, ahol minden lap egy meghatározott pozícióban landol, és vagy állva vagy fordítva orientált. A válasz leírja magát az elrendezést, visszhangozza az használt egész magot, és felsorolja a húzott lapokat - mindegyik pozíciójának címkéjével, orientációjával és a laphoz ebben az orientációban kapcsolódó jelentésével. A mag a tervezés szíve: hagyod ki, és a szerver generál egyet neked és visszaadja; megadod, és újra generálod az azonos húzást, ami lehetővé teszi az olvasások megoszthatóságát, tesztelhetőségét és ellenőrizhetőségét. Az allowReversed jelző dönti el, hogy a fordított lapok egyáltalán lehetséges-e. Más elrendezések - egylapos, Kelta kereszt, patkó, kapcsolat és előretekintő - testvér végpontok, amelyeket ugyanaz a pakli és magozási mechanizmus hajt.
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
Ezt akkor használd, ha olyan tarot olvasást szeretnél, amit igény szerint reprodukálhatsz, nem pedig egy egyszeri véletlen húzást. Kérdés a visszaadott magot, és később újrarajzolhatod a pontosan ugyanazt a három lapot - egy megosztott linkben, egy elmentett olvasásban, egy regressziós tesztben vagy egy támogatási jegyben - anélkül, hogy magad tárolnád a laplistát. Használj rögzített magot a tesztekben, hogy az UI és a szöveg determinisztikusan jelenjen meg, és hagyd, hogy a szerver friss magot verjen a termelésben valódi változatosság érdekében. A háromlapos elrendezést akkor használd specifikusan, ha egy kompakt múlt/jelen/jövő stílusú szerkezetet szeretnél; váltson egy testvér végpontra, ha egy több pozíciójú elrendezés jobban illik az élményhez.
Notes
A lapok képei a Rider-Waite-Smith pakliból származnak (A. E. Waite & Pamela Colman Smith, 1909), amelyek közjószágban vannak. Állítsd az allowReversed értékét hamisra, hogy csak álló lapokat húzz - hasznos kezdőbarát olvasásoknál, ahol a fordított jelentés zavaros lenne. Ugyanaz a mag csak ugyanazt az elrendezést és ugyanazt az allowReversed beállítást reprodukálja.
Try the Hártyás Kártya Húzás API
Grab a key and make your first call in under a minute.