Tarot

Trois jeux : Rider-Waite-Smith (78 cartes), Tarot de Marseille (78) et Lenormand (36). Chaque carte dans chaque réponse du tarot possède une image, et POST /v1/interpret/tarot transforme le tirage en interprétation : chaque position dans le contexte, le résumé de tout le tirage et un conseil.

Choisissez le style des cartes

GET /v1/tarot/decks renvoie chaque jeu, ses tirages et les ensembles de style qui peuvent être passés comme art à n’importe quelle route du tarot (dans le corps POST ou en tant que ?art= en GET). Tous les ensembles sont du domaine public et sont servis depuis notre CDN.

Jeu	art	Cartes
Rider-Waite-Smith	rws-1909 (par défaut), rws-restored, rws-vector	78
Tarot de Marseille	arnoult-1748	78
Lenormand	dondorf	35 sur 36, sans la Lune

Chaque carte reçoit un image avec urlSmall (300 px de largeur, pour les cartes d’environ 150 px à l’écran), url (600 px), url2x (1200 px), width, height et art. Le tirage renvoie également back, le dos de la carte, afin que la page puisse d’abord montrer les cartes face cachée. Un art provenant d’un autre jeu renvoie une erreur 400 INVALID_ART avec la liste des valeurs autorisées. Une carte pour laquelle le jeu ne possède pas d’image (la Lune dans le Lenormand) est indiquée dans missing de cet ensemble et arrive sans image; affichez donc pour elle une carte textuelle.

cURL

curl -X POST https://api.astroway.info/v1/tarot/rider-waite/draw/three-card \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "seed": 12345, "art": "rws-restored" }'

{
  "drawn": [
    {
      "position": { "index": 0, "name": "Past", "meaning": "Forces from the past shaping the situation." },
      "card": {
        "slug": "8-of-pentacles",
        "name": "Eight of Pentacles",
        "image": {
          "url": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles.webp",
          "url2x": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles@2x.webp",
          "urlSmall": "https://cdn.astroway.info/tarot/rws-restored/8-of-pentacles-300.webp",
          "width": 600,
          "height": 1028,
          "art": "rws-restored"
        }
      },
      "reversed": false
    }
  ],
  "back": { "url": "https://cdn.astroway.info/tarot/rws-1909/back.webp", "url2x": "https://cdn.astroway.info/tarot/rws-1909/back@2x.webp", "urlSmall": "https://cdn.astroway.info/tarot/rws-1909/back-300.webp", "width": 600, "height": 1039, "art": "rws-1909" }
}

Le tirage POST /v1/tarot/rider-waite/draw/three-card coûte 10 crédits.

Textes des cartes sans modèle

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk fonctionne sans clé et renvoie pour chaque carte une description composée de trois paragraphes (image, signification droite, signification renversée) ainsi que des textes sur love, career, finance, health et spirit pour upright et reversed, ainsi qu’un nom localisé name et jusqu’à cinq keywords pour chaque côté. Sans le paramètre cards, toutes les 78 cartes sont renvoyées. Les textes ne changent pas, donc téléchargez les cartes affichées par la page et mettez-les en cache.

curl 'https://api.astroway.info/v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk'

Interprétation du tirage complet

POST /v1/interpret/tarot accepte le jeu, le tirage, les cartes et une question facultative, puis écrit l’interprétation dans la langue spécifiée par language (21 langues). Les cartes peuvent être transmises sous forme de chaînes, d’objets { "slug", "reversed" } ou d’un tableau drawn provenant de toute réponse de tirage sans modification.

Node.js

const headers = { 'Content-Type': 'application/json', 'X-Api-Key': process.env.ASTROWAY_API_KEY };
const api = (path, body) =>
  fetch(`https://api.astroway.info/v1${path}`, { method: 'POST', headers, body: JSON.stringify(body) }).then((r) => r.json());

const { data: spread } = await api('/tarot/rider-waite/draw/three-card', { art: 'rws-1909' });
const { data: reading } = await api('/interpret/tarot', {
  spread: 'three-card',
  question: 'What should I focus on at work?',
  cards: spread.drawn,
  language: 'en',
});

for (const p of reading.positions) {
  console.log(p.position, p.card.name, p.reversed ? '(reversed)' : '', p.card.image.url);
  console.log(' ', p.reading);
}
console.log('Summary:', reading.synthesis);

Dans la réponse, positions[] (position, carte avec image, reversed, reading), synthesis, advice et disclaimer. Les cartes Rider-Waite-Smith possèdent également nameLocalized et positionLocalized dans la langue de l’interprétation. L’interprétation coûte 100 crédits (niveau 4) et est disponible sur le forfait Free ; avec votre propre clé de modèle, c’est moins cher, voir Votre clé de modèle.

Note

L’interprétation est un texte généré basé sur la signification traditionnelle de chaque carte dans sa position. L’API associe les cartes, leur orientation et leurs positions à votre requête et élimine les interprétations qui omettent une carte, mais considérez le texte comme une invitation à la réflexion, et non comme une prédiction.