Перейти до вмісту
AstroWay/api v2.254.12 · docs
усі системи в нормі

Таро

Три колоди: Rider-Waite-Smith (78 карт), Марсельське Таро (78) і Ленорман (36). Кожна карта в кожній відповіді таро має картинку, а POST /v1/interpret/tarot перетворює розклад на тлумачення: кожна позиція в контексті, підсумок усього розкладу й одна порада.

Оберіть оформлення карт

Section titled “Оберіть оформлення карт”

GET /v1/tarot/decks повертає кожну колоду, її розклади й набори оформлення, які можна передати як art у будь-який маршрут таро (у тілі POST або як ?art= у GET). Усі набори є суспільним надбанням і віддаються з нашого CDN.

КолодаartКарт
Rider-Waite-Smithrws-1909 (типово), rws-restored, rws-vector78
Марсельське Тароarnoult-174878
Ленорманdondorf35 з 36, без Місяця

Кожна карта отримує image з urlSmall (300 px завширшки, для карт до приблизно 150 px на сторінці), url (600 px), url2x (1200 px), width, height і art. Розклад також повертає back, сорочку карти, щоб сторінка могла спершу показати карти лицем донизу. art іншої колоди дає 400 INVALID_ART зі списком допустимих. Карта, для якої в наборі немає картинки (Місяць у Ленорман), вказана в missing цього набору й приходить без image, тож показуйте для неї текстову карту.

Terminal window
curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "seed": 12345, "art": "rws-restored" }'
 
{
  "drawn": [
    {
      "position": { "index": 0, "name": "Past", "meaning": "Forces from the past shaping the situation." },
      "card": {
        "slug": "8-of-pentacles",
        "name": "Eight of Pentacles",
        "image": {
          "url": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles.webp",
          "url2x": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles@2x.webp",
          "urlSmall": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles-300.webp",
          "width": 600,
          "height": 1028,
          "art": "rws-restored"
        }
      },
      "reversed": false
    }
  ],
  "back": { "url": "https://cdn.astroway.info/tarot/rws-1909/back.webp", "url2x": "https://cdn.astroway.info/tarot/rws-1909/back@2x.webp", "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/back-300.webp", "width": 600, "height": 1039, "art": "rws-1909" }
}

Розклад POST /v1/tarot/rider-waite/draw/three-card коштує 10 кредитів.

Тексти карт без моделі

Section titled “Тексти карт без моделі”

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk працює без ключа й повертає для кожної карти description з трьох абзаців (зображення, пряме значення, перевернуте значення) і текст про love, career, finance, health і spirit для upright і reversed, разом із локалізованою назвою name і до п’яти keywords на кожен бік. Без cards приходять усі 78. Тексти не змінюються, тож завантажуйте карти, які показує сторінка, і кешуйте їх.

Terminal window
curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'

Тлумачення всього розкладу

Section titled “Тлумачення всього розкладу”

POST /v1/interpret/tarot приймає колоду, розклад, карти й необов’язкове питання і пише тлумачення мовою з language (21 мова). Карти можна передати слагами, об’єктами { "slug", "reversed" } або масивом drawn з будь-якої відповіді розкладу без змін.

const headers = { 'Content-Type': 'application/json', 'X-Api-Key': process.env.ASTROWAY_API_KEY };
const api = (path, body) =>
  fetch(`https://api.astroway.info/v1${path}`, { method: 'POST', headers, body: JSON.stringify(body) }).then((r) => r.json());


const { data: spread } = await api('/tarot/rider-waite/draw/three-card', { art: 'rws-1909' });
const { data: reading } = await api('/interpret/tarot', {
  spread: 'three-card',
  question: 'What should I focus on at work?',
  cards: spread.drawn,
  language: 'en',
});


for (const p of reading.positions) {
  console.log(p.position, p.card.name, p.reversed ? '(reversed)' : '', p.card.image.url);
  console.log(' ', p.reading);
}
console.log('Summary:', reading.synthesis);

У відповіді positions[] (позиція, карта з image, reversed, reading), synthesis, advice і disclaimer. Карти Rider-Waite-Smith також мають nameLocalized і positionLocalized мовою тлумачення. Тлумачення коштує 100 кредитів (Tier 4) і доступне на тарифі Free; з власним ключем моделі дешевше, див. Свій ключ до моделі.

Корисно?
Запропонувати правку

Останнє оновлення: