API de tarô
Este endpoint realiza uma tiragem com semente e reprodutível a partir do baralho Rider-Waite-Smith de 78 cartas para a tiragem de três cartas. Devolve os metadados da tiragem, a semente inteira que governou o embaralhamento e as cartas tiradas com as suas posições, orientações e significados — para que qualquer leitura possa ser repetida exatamente passando de volta a semente.
API de tarô
Dada uma pergunta opcional e uma semente opcional, o endpoint tira cartas do baralho completo de 78 cartas para a disposição de três cartas, com cada carta a cair numa posição definida e orientada para cima ou invertida. A resposta descreve a própria tiragem, devolve a semente inteira utilizada e lista as cartas tiradas — cada uma carregando o rótulo da sua posição, a sua orientação e o significado associado a essa carta nessa orientação. A semente é o cerne do desenho: omita-a e o servidor gera uma por si e devolve-a; forneça-a e regenera uma tiragem idêntica, o que torna as leituras partilháveis, testáveis e auditáveis. O indicador allowReversed decide se as inversões são sequer possíveis. Outras tiragens — uma carta, Cruz Celta, ferradura, relacionamento e ano à frente — são endpoints irmãos movidos pelo mesmo baralho e mecanismo de semente.
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": "…"
}
]
}
}Parâmetros
| name | type | Obrigatório | |
|---|---|---|---|
| question | string | não | 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 | não | An optional integer that fixes the shuffle; pass the seed from a prior response to regenerate an identical draw. |
| allowReversed | boolean | não | An optional boolean (default true) that controls whether cards may appear reversed; set false to draw upright cards only. |
Quando usar
Recorra a isto quando quiser uma leitura de tarô que possa reproduzir a pedido em vez de uma tiragem aleatória única. Capture a semente devolvida e poderá voltar a renderizar exatamente as mesmas três cartas mais tarde — numa ligação partilhada, numa leitura guardada, num teste de regressão ou num pedido de suporte — sem armazenar a lista de cartas você mesmo. Use uma semente fixa nos testes para que a sua interface e o seu texto se rendam de forma determinística, e deixe o servidor cunhar uma semente nova em produção para verdadeira variedade. Recorra à tiragem de três cartas especificamente quando quiser uma estrutura compacta ao estilo passado/presente/futuro; mude para um endpoint irmão quando uma disposição com mais posições se adequar melhor à experiência.
Notas
As imagens das cartas são do baralho Rider-Waite-Smith (A. E. Waite & Pamela Colman Smith, 1909), que é de domínio público. Defina allowReversed como false para tirar apenas cartas para cima — útil para leituras acessíveis a principiantes, onde os significados invertidos acrescentariam confusão. A mesma semente reproduz uma tiragem apenas para a mesma disposição e a mesma definição de allowReversed.
Experimente a API de Tiragem de Três Cartas
Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.