POST/api/astro/tarot/draw/1 crédito

Sorteio de tarô

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.

https://api.occultapi.com/api/astro/tarot/draw/

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.
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.

Exemplo de requisição

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

Resposta

{
  "data": {
    "question": "What should I focus on this month?",
    "seed": "sample-draw",
    "reproducible": "Send this seed back to get exactly this draw again.",
    "deck": "Rider-Waite-Smith, 78 cards",
    "reversals_allowed": true,
    "cards": [
      {
        "position": 1,
        "id": 50,
        "name": "Ace of Swords",
        "arcana": "minor",
        "suit": "Swords",
        "rank": "Ace",
        "number": 1,
        "element": "air",
        "upright": "clarity, breakthrough, truth cutting through",
        "reversed": "confusion, a truth misused",
        "orientation": "reversed",
        "meaning": "confusion, a truth misused",
        "yes_no": "no"
      },
      {
        "position": 2,
        "id": 32,
        "name": "Page of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Page",
        "number": 11,
        "element": "fire",
        "upright": "curiosity, an idea, enthusiasm",
        "reversed": "unfocused energy, an idea unformed",
        "orientation": "reversed",
        "meaning": "unfocused energy, an idea unformed",
        "yes_no": "no"
      },
      {
        "position": 3,
        "id": 31,
        "name": "Ten of Wands",
        "arcana": "minor",
        "suit": "Wands",
        "rank": "Ten",
        "number": 10,
        "element": "fire",
        "upright": "burden, overload, carrying too much",
        "reversed": "putting a load down, delegation",
        "orientation": "upright",
        "meaning": "burden, overload, carrying too much",
        "yes_no": "no"
      }
    ],
    "count": 3
  },
  "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.