Τάρο

Τρεις κολόδες: Rider-Waite-Smith (78 κάρτες), Μαρσελίτικο Τάρο (78) και Lenormand (36). Κάθε κάρτα σε κάθε απάντηση ταρό έχει εικόνα, και το POST /v1/interpret/tarot μετατρέπει τον διάagrama σε ερμηνεία: η κάθε θέση στο πλαίσιο, το σύνολο του διαγράμματος και μία σύσταση.

Ορίστε το στυλ των καρτών

GET /v1/tarot/decks επιστρέφει κάθε κολόδο, τα διαγράμματα της και τα σύνολα στυλ που μπορούν να δοθούν ως art σε οποιοδήποτε δromo ταρό (στο σώμα POST ή ως ?art= σε GET). Όλα τα σύνολα είναι δημόσια κτήνη και παρέχονται από το CDN μας.

Κολόδα	art	Κάρτες
Rider-Waite-Smith	rws-1909 (προεπιλογή), rws-restored, rws-vector	78
Μαρσεльське Таρο	arnoult-1748	78
Ленорман	dondorf	35 από 36, χωρίς Μήνα

Κάθε κάρτα λαμβάνει ένα image με urlSmall (300 πξ πλατύς, για κάρτες έως περίπου 150 πξ στη σελίδα), url (600 πξ), url2x (1200 πξ), width, height και art. Ο διάγραμμα επιστρέφει επίσης το back, το πίσω μέρος της κάρτας, ώστε η σελίδα να μπορεί πρώτα να εμφανίσει τις κάρτες με το πρόσωπο κάτω. Το art άλλης κολόδας επιστρέφει 400 INVALID_ART με λίστα των επιτρεπτών. Η κάρτα για την οποία δεν υπάρχει εικόνα στο σύνολο (Ο Μήνας στο Lenormand) είναι καθορισμένη στο missing αυτού του συνόλου και έρχεται χωρίς image, άρα εμφανίστε για αυτή κείμενο κάρτα.

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

Ο διάγραμμα POST /v1/tarot/rider-waite/draw/three-card κοστίζει 10 πιστωτικά.

Κείμενα καρτών χωρίς μοντέλο

GET /v1/public/tarot/texts?cards=the-fool,9-of-swords&lang=uk λειτουργεί χωρίς κλειδί και επιστρέφει για κάθε κάρτα μια description με τρία παραγράφους (εικόνα, ευθεία σημασία, ανεστραμμένη σημασία) και κείμενο για love, career, finance, health και spirit για upright και reversed, μαζί με την τοπικοποιημένη ονομασία name και έως πέντε keywords για κάθε πλευρά. Χωρίς cards λαμβάνουμε όλες τις 78. Τα κείμενα δεν αλλάζουν, οπότε κατεβάζε τις κάρτες που εμφανίζει η σελίδα και κεσού τα.

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

Ερμηνεία ολόκληρου του διαγράμματος

POST /v1/interpret/tarot δέχεται μια κολόδα, ένα διάγραμμα, τις κάρτες και μια προαιρετική ερώτηση και γράφει ερμηνεία στη γλώσσα του language (21 γλώσσες). Οι κάρτες μπορούν να δοθούν ως όρισματα, ως αντικείμενα { "slug", "reversed" } ή ως μαсив drawn από οποιαδήποτε απάντηση διαγράμματος χωρίς αλλαγές.

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);

Στην απάντηση positions[] (θέση, κάρτα με image, reversed, reading), synthesis, advice και disclaimer. Οι κάρτες Rider-Waite-Smith έχουν επίσης nameLocalized και positionLocalized στη γλώσσα της ερμηνείας. Η ερμηνεία κοστίζει 100 πιστωτικά (Tier 4) και είναι διαθέσιμη στο δωρεάν ταρίφ; με το δικό σας κλειδί μοντέλου είναι πιο φτηνή, βλ. Το δικό σας κλειδί μοντέλου.

Σημείωση

Η ερμηνεία είναι γεννημένος κείμενο που βασίζεται στο παραδοσιακό νόημα κάθε κάρτας στην θέση της. Το API συνδέει τις κάρτες, τη θέση τους και την θέση στο αίτημα σας και απορρίπτει την ερμηνεία που αγνοεί μια κάρτα, αλλά λάβε το κείμενο ως έμπνευση για σκέψεις, όχι ως πρόβλεψη.