POST/api/astro/tarot/yes-no/1 crédito

Tarô sim ou não

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.

https://api.occultapi.com/api/astro/tarot/yes-no/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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.

Exemplo de requisição

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

Resposta

{
  "data": {
    "question": "Should I take the offer?",
    "seed": "sample-yesno",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 14,
        "name": "Temperance",
        "arcana": "major",
        "suit": null,
        "rank": null,
        "number": 14,
        "element": null,
        "upright": "balance, moderation, patience, blending",
        "reversed": "imbalance, excess, impatience",
        "orientation": "upright",
        "meaning": "balance, moderation, patience, blending",
        "yes_no": "yes"
      }
    ],
    "answer": "yes",
    "card": "Temperance",
    "orientation": "upright",
    "meaning": "balance, moderation, patience, blending",
    "how_decided": "Each card has a traditional leaning. A reversal flips yes to no and no to yes; an ambivalent card stays ambivalent. Conventions differ between readers, so this one is stated rather than left implicit."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.