curl -X POST https://api.occultapi.com/api/astro/tarot/yes-no/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"Should I take the offer?","seed":"sample-yesno"}'
Uma carta tirada para uma pergunta, lida como sim, não ou talvez.
O critério da resposta é explícito, e não implícito, porque as convenções variam entre tarólogos e um "yes" isolado esconde qual delas o gerou. Cada carta tem uma inclinação tradicional — o Sol e o Ás de Copas tendem ao sim, a Torre e o Nove de Espadas tendem ao não, o Dois de Espadas e o Sete de Copas são ambivalentes. Uma inversão transforma um sim em não e um não em sim; uma carta ambivalente continua ambivalente em qualquer orientação. Defina `allow_reversed` como false para ler apenas na posição normal.
A carta e todas as suas palavras-chave são retornadas com o veredito, porque um "no" sozinho não é uma leitura, e é a carta que carrega o significado.
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.
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.
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.