API de Tarot
Acest endpoint efectuează un traseu de deschis, reproducibil din cartea de 78 de cărți Rider-Waite-Smith pentru răspândirea a trei cărți. Returnează metadata pentru răspândire, semănașul întreg care a guvernat amestecul și cărțile traseu cu poziția, orientarea și sensul lor - astfel orice citire poate fi reluată exact prin transmiterea semănașului înapoi.
API de Tarot
În funcție de o întrebare opțională și de un semănaș opțional, endpoint-ul trasează cărțile din cartea de 78 de cărți pentru răspândirea a trei cărți, cu fiecare carte căzând într-o poziție definită și orientată fie în sus, fie invers. Răspunsul descrie răspândirea în sine, repetă semănașul întreg folosit și listează cărțile traseu - fiecare purtând eticheta de poziție, orientarea și sensul atașat cărții în acea orientare. Semănașul este inima proiectului: omițile-l și serverul generează un pentru tine și îl returnează; furnizează-l și regenerează o deschidere identică, care face citirile partajabile, testabile și auditabile. Flag-ul allowReversed decide dacă inversările sunt posibile deloc. Alte răspândiri - a trei cărți, Crucea Celică, căruța, relația și anul viitor - sunt endpoint-uri surori, împinse de același set de cărți și mecanism de semănaș.
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
Săptămânați la acesta când doriți o citire de tarot care puteți reproduce la cerere, mai degrabă decât o deschidere aleatorie unică. Câțițiți semănașul returnat și puteți re-reprezenta exact aceleași trei cărți mai târziu - într-o legătură partajată, o citire stăruită, un test de regresie sau o cerere de suport - fără să vă stocați lista de cărți în sine. Folosițiți un semănaș fix în teste pentru a vă faceți UI-ul și copia să se reprezinte deterministic și lăsațiți serverul să mintă un semănaș nou în producție pentru a vă oferi adevărată varietate.
Notes
Imaginile cărților sunt din cartea de cărți Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), care este în domeniul publicului. Setațiți allowReversed la false pentru a trasați cărțile în sus numai - util pentru citiri prietenoase pentru începători unde sensurile inverse ar adăuga confuzie. Același semănaș reproducează deschiderea doar pentru aceeași răspândire și pentru aceeași setare a allowReversed.
Try the Three-Card Draw API
Grab a key and make your first call in under a minute.