curl -X POST https://api.occultapi.com/api/astro/tarot/draw/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What should I focus on this month?","count":3,"seed":"sample-draw"}'
Tira cartas de um baralho Rider-Waite-Smith embaralhado, de setenta e oito cartas.
As cartas são tiradas sem reposição, então um sorteio nunca repete uma carta. Cada uma é retornada com seu arcano, naipe, valor, número, orientação e as palavras-chave padrão para a orientação em que saiu.
Toda resposta traz a `seed` que a gerou, e reenviar essa seed reproduz o sorteio exatamente — mesmas cartas, mesma ordem, mesma orientação. Se você a omitir, uma seed é gerada e retornada; assim, um sorteio novo é o padrão e sempre é possível repeti-lo depois. É isso que permite a um cliente guardar uma leitura e exibi-la de novo, em vez de dar ao consulente uma resposta diferente para a mesma pergunta.
`allow_reversed` e `reversal_chance` existem porque os tarólogos diferem: alguns trabalham apenas com cartas na posição normal, alguns invertem cerca de metade do baralho, outros bem menos.
Campos da requisição
Campo
Tipo
Obrigatório
Observações
allow_reversed
boolean
opcional
Se as cartas podem sair invertidas. Alguns tarólogos trabalham apenas com cartas na posição normal.
count
integer
opcional
Quantas cartas tirar, no máximo 21. As cartas são tiradas sem reposição, então nenhuma pode se repetir.
min 1 · max 21
question
string
opcional
Opcional. Devolvido na resposta e incorporado a uma seed gerada.
reversal_chance
number (double)
opcional
Probabilidade de uma inversão, quando as inversões são permitidas.
min 0 · max 1
seed
string
opcional
Envie uma seed para reproduzir um sorteio exatamente. Se você a omitir, uma seed é gerada e retornada, então qualquer sorteio pode ser repetido depois.