Tarot API
هذا endpoint يقوم بسحب مُحدَّد وقابل لإعادة الإنتاج من مجموعة 78 بطاقة Rider-Waite-Smith لتوزيع ثلاث بطاقات. يُرجع بيانات التوزيع، والبذرة العددية التي تحكم الخلط، والبطاقات المسحوبة مع مواقعها واتجاهاتها ومعانيها - بحيث يمكنك إعادة القراءة تمامًا بتمرير البذرة مرة أخرى.
Tarot API
مع سؤال اختياري وبذرة اختيارية، يقوم الـendpoint بسحب بطاقات من مجموعة الـ78 بطاقة لتوزيع ثلاث بطاقات، بحيث كل بطاقة توضع في موضع محدد وتكون إما موجهة للأعلى أو مقلوبة. الرد يصف التوزيع نفسه، ويعيد البذرة العددية المستخدمة، ويُدرج البطاقات المسحوبة - كل واحدة مع تسمية موضعها، واتجاهها، والمعنى المرتبط بهذه البطاقة في ذلك الاتجاه. البذرة هي قلب التصميم: إذا تركتها، السيرفر يولد واحدة لك ويرجعها؛ إذا زودتها، تعيد سحبًا متطابقًا، وهذا يجعل القراءات قابلة للمشاركة، والاختبار، والتدقيق. علمية allowReversed تحدد إذا كانت القلبات ممكنة أم لا. توزيعات أخرى - بطاقة واحدة، الصليب الكلتي، الحدوة، العلاقات والسنة القادمة - هي endpoints شقيقة تستخدم نفس المجموعة وآلية البذرة.
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
استخدم هذا عندما تريد قراءة تاروت يمكنك إعادة إنتاجها عند الطلب بدلًا من سحب عشوائي لمرة واحدة. احفظ البذرة المرتجعة وتقدر تعيد عرض نفس الثلاث بطاقات لاحقًا - في رابط مشترك، قراءة محفوظة، اختبار رجعي، أو تذكرة دعم - بدون ما تخزن قائمة البطاقات بنفسك. استخدم بذرة ثابتة في الاختبارات عشان واجهتك والنصوص تظهر بشكل حتمي، وخلي السيرفر يولد بذرة جديدة في الإنتاج لتنوع حقيقي. استخدم توزيع الثلاث بطاقات خصوصًا لما تحتاج هيكل مختصر الماضي/الحاضر/المستقبل؛ وانتقل إلى endpoint شقيق إذا كان توزيع بأكثر مواضع يناسب التجربة أكثر.
Notes
صورة البطاقات هي مجموعة Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909)، وهي ضمن الملكية العامة. اضبط allowReversed إلى false لسحب بطاقات موجهة للأعلى فقط - مفيد للقراءات للمبتدئين حيث معاني القلبات قد تسبب ارتباك. نفس البذرة تعيد سحبًا فقط لنفس التوزيع وإعداد allowReversed نفسه.
Try the سحب ثلاث بطاقات API
Grab a key and make your first call in under a minute.