Přeskočit na obsah
AstroWay/api v2.254.12 · cs
všechny systémy jsou v pořádku

Tarot

Tři balíčky: Rider-Waite-Smith (78 karet), Marcellské tarot (78) a Lenormand (36). Každá karta v každé odpovědi tarotu má obrázek a POST /v1/interpret/tarot převádí rozložení na výklad: každá pozice v kontextu, souhrn celého rozložení a jedna rada.

Vyber vzhled karet

Sekce “Vyber vzhled karet”

GET /v1/tarot/decks vrací každý balíček, jeho rozložení a sady vzhledu, které lze předat jako art v jakékoli cestě tarota (v těle POST nebo jako ?art= v GET). Všechny sady jsou veřejným statkem a jsou poskytovány z našeho CDN.

BalíčekartKaret
Rider-Waite-Smithrws-1909 (výchozí), rws-restored, rws-vector78
Marcellské tarotarnoult-174878
Lenormanddondorf35 z 36, bez Měsíce

Každá karta obdrží image s urlSmall (300 px na šířku, pro karty přibližně 150 px na stránce), url (600 px), url2x (1200 px), width, height a art. Rozložení také vrací back, rub karty, aby stránka mohla nejprve ukázat karty lícem dolů. art jiného balíčku vrátí chybu 400 INVALID_ART se seznamem povolených. Karta, pro kterou v sadě není obrázek (Měsíc u Lenormandu), je uvedena v missing této sady a přichází bez image, takže pro ni zobraz textovou kartu.

Terminál
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" }
}

Rozložení POST /v1/tarot/rider-waite/draw/three-card stojí 10 kreditů.

Texty karet bez modelu

Sekce “Texty karet bez modelu”

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk funguje bez klíče a vrací pro každou kartu description ze tří odstavců (obraz, přímý význam, obrácený význam) a text o love, career, finance, health a spirit pro upright i reversed, spolu s lokalizovaným názvem name a až pěti keywords na každou stranu. Bez cards jsou vráceny všechny 78. Texty se nemění, takže načti karty, které stránka zobrazuje, a kešuj je.

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

Výklad celého rozložení

Sekce “Výklad celého rozložení”

POST /v1/interpret/tarot přijímá balíček, rozložení, karty a nepovinnou otázku a píše výklad jazykem z language (21 jazyků). Kartami lze předávat jako jednotlivé hodnoty, objekty { "slug", "reversed" } nebo pole drawn z jakékoli odpovědi na rozložení bez změn.

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);

V odpovědi positions[] (pozice, karta s image, reversed, reading), synthesis, advice a disclaimer. Kartami Rider-Waite-Smith také mají nameLocalized a positionLocalized jazykem výkladu. Výklad stojí 100 kreditů (Tier 4) a je dostupný v tarifu Free; s vlastním klíčem modelu je levnější, viz Svůj klíč k modelu.

Užitečné?
Navrhnout úpravu

Aktualizováno: