Tarot Card API - cards.apify.pl

🇵🇱

Polski

🔮 Po co to API?

Tarot Card API to prosty i niezawodny sposób na integrację losowania kart Tarota w Twojej aplikacji. Idealny do tworzenia aplikacji wróżbiarskich, gier, narzędzi edukacyjnych lub chatbotów.

✓ 78 kart Tarota (22 Major Arcana + 56 Minor Arcana)
✓ Deterministyczne tasowanie oparte na session ID
✓ Karty odwrócone (reversed) dla pełnej interpretacji
✓ Bezpłatne i bez limitów

📖 Jak używać?

API obsługuje 4 różne formaty zapytań:

GET /spread/{sid} ← losuje 1 kartę

GET /spread/{sid}/{howmuch} ← losuje wybraną liczbę kart

GET /spread?sid={sid} ← losuje 1 kartę

GET /spread?sid={sid}&howmuch={liczba} ← losuje wybraną liczbę

sid - Identyfikator sesji (dowolny tekst). Ten sam sid zwraca karty z tej samej potasowanej talii.

💡 Co użyć jako sid?

• YYYYMMDD{losowe znaki} - np. 20241122abc (data urodzenia + losowe znaki z klawiatury = odpowiednik tasowania kart)
• timestamp - np. 1700123456 (najlepsze dla unikalnych sesji)
• username_YYYYMMDD - np. anna_20241122

⚠️ Nie używaj wartości z przykładów - każdy użytkownik powinien mieć własny unikalny sid!

howmuch - Liczba kart do wylosowania (1-78, domyślnie 1)

💡 Przykłady

/spread/przyklad1

/spread/przyklad2/3

/spread?sid=przyklad3&howmuch=5

⚙️ Jak to działa?

1. Pierwsze wywołanie z nowym sid tworzy potasowaną talię 78 kart
2. Każda karta jest losowo oznaczona jako normalna lub odwrócona (reversed)
3. Kolejne wywołania z tym samym sid pobierają następne karty z góry talii
4. Talia pozostaje w sesji - użyj innego sid aby stworzyć nową

🇬🇧

English

🔮 What is this API?

Tarot Card API is a simple and reliable way to integrate tarot card drawing into your application. Perfect for building divination apps, games, educational tools, or chatbots.

✓ 78 Tarot cards (22 Major Arcana + 56 Minor Arcana)
✓ Deterministic shuffling based on session ID
✓ Reversed cards for complete interpretation
✓ Free and unlimited

📖 How to use?

API supports 4 different request formats:

GET /spread/{sid} ← draws 1 card

GET /spread/{sid}/{howmuch} ← draws specified number

GET /spread?sid={sid} ← draws 1 card

GET /spread?sid={sid}&howmuch={number} ← draws specified number

sid - Session identifier (any string). Same sid returns cards from the same shuffled deck.

💡 What to use as sid?

• YYYYMMDD{random chars} - e.g. 20241122abc (birthdate + random keyboard chars = shuffling equivalent)
• timestamp - e.g. 1700123456 (best for unique sessions)
• username_YYYYMMDD - e.g. john_20241122

⚠️ Don't use example values - each user should have their own unique sid!

howmuch - Number of cards to draw (1-78, default 1)

💡 Examples

/spread/example1

/spread/example2/3

/spread?sid=example3&howmuch=5

⚙️ How it works?

1. First call with a new sid creates a shuffled deck of 78 cards
2. Each card is randomly marked as normal or reversed
3. Subsequent calls with the same sid draw next cards from the top
4. Deck persists in session - use different sid to create a new one