Pular para o conteúdo
AstroWay/api v2.254.12 · pt
todos os sistemas normais

Tarot

Três baralhos: Rider-Waite-Smith (78 cartas), Tarô de Marselha (78) e Lenormand (36). Cada carta em cada resposta de tarô tem uma imagem, e POST /v1/interpret/tarot transforma a disposição numa interpretação: cada posição no contexto, resumo de toda a disposição e um conselho.

Escolhe o estilo das cartas

Seção intitulada “Escolhe o estilo das cartas”

GET /v1/tarot/decks devolve cada baralho, as suas disposições e conjuntos de estilos, que podem ser passados como art em qualquer rota de tarô (no corpo do POST ou como ?art= no GET). Todos os conjuntos são domínio público e são servidos a partir do nosso CDN.

BaralhoartCartas
Rider-Waite-Smithrws-1909 (padrão), rws-restored, rws-vector78
Tarô de Marselhaarnoult-174878
Lenormanddondorf35 de 36, sem a Lua

Cada carta recebe image com urlSmall (300 px de largura, para cartas até cerca de 150 px na página), url (600 px), url2x (1200 px), width, height e art. A disposição também devolve back, a parte de trás da carta, para que a página possa inicialmente mostrar as cartas viradas para baixo. Um art de outro baralho devolve 400 INVALID_ART com a lista de valores permitidos. A carta para a qual o conjunto não tem imagem (a Lua no Lenormand) está indicada em missing desse conjunto e chega sem image, portanto mostra uma carta textual para ela.

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" }
}

A disposição POST /v1/tarot/rider-waite/draw/three-card custa 10 créditos.

Textos das cartas sem modelo

Seção intitulada “Textos das cartas sem modelo”

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk funciona sem chave e devolve para cada carta description com três parágrafos (imagem, significado direto, significado invertido) e texto sobre love, career, finance, health e spirit para upright e reversed, juntamente com o nome localizado name e até cinco keywords por lado. Sem cards são devolvidas todas as 78. Os textos não mudam, portanto carrega as cartas que a página mostra e faz cache delas.

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

Interpretação de toda a disposição

Seção intitulada “Interpretação de toda a disposição”

POST /v1/interpret/tarot aceita o baralho, a disposição, as cartas e uma pergunta opcional e gera uma interpretação no idioma especificado por language (21 idiomas). As cartas podem ser enviadas como slugs, objetos { "slug", "reversed" } ou como um array drawn de qualquer resposta de disposição, sem alterações.

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

Na resposta há positions[] (posição, carta com image, reversed, reading), synthesis, advice e disclaimer. As cartas Rider-Waite-Smith também têm nameLocalized e positionLocalized no idioma da interpretação. A interpretação custa 100 créditos (Tier 4) e está disponível no plano Free; com a tua própria chave de modelo fica mais barato, vê A tua chave de modelo.

Útil?
Sugerir edição

Última atualização: