Aplikacje randkowe

Astrologiczna kompatybilność to kluczowy czynnik retencji w aplikacjach randkowych takich jak Bumble, Hinge, Tinder, Tantan oraz w aplikacjach astrologicznych typu NUiT, Struck. API AstroWay dostarcza gotowy wynik synastrii w skali 0–100 za jednym wywołaniem — bez konieczności posiadania własnego silnika efemeryd i bez licencji na Solar Fire ($495).

Jak to działa

1. Użytkownik wprowadza datę, godzinę i miejsce urodzenia podczas rejestracji
2. Podczas dopasowania — twój backend wywołuje /v1/synastry z danymi obu osób
3. API zwraca compatibility.score (0–100) oraz label (harmonious/balanced/mixed/challenging)
4. Wynik jest używany jako jeden z czynników rankingowych

Algorytm dopasowania
  ├── Bliskość lokalizacji         (40%)
  ├── Wspólne zainteresowania      (30%)
  ├── Astrologiczna kompatybilność (20%)  ← AstroWay API
  └── Inne sygnały                 (10%)

Kluczowe endpointy

Endpoint	Kredyty	Co zwraca
/v1/synastry	50	Krzyżowe aspekty + wynik 0–100
/v1/human-design/compatibility	100	Kompatybilność HD (typ + strategia)
/v1/horoscope/compatibility	50	Analiza tekstowa kompatybilności

Wzorzec integracji

// Podczas dopasowania — wywołaj synastrię
async function getCompatibility(userA: UserProfile, userB: UserProfile) {
  const result = await astrowayClient.synastry({
    chart1: {
      date: userA.birthDate,
      time: userA.birthTime || '12:00:00', // południe domyślne, jeśli nieznane
      timezoneOffset: userA.tzOffset,
      latitude: userA.birthLat,
      longitude: userA.birthLng,
    },
    chart2: {
      date: userB.birthDate,
      time: userB.birthTime || '12:00:00',
      timezoneOffset: userB.tzOffset,
      latitude: userB.birthLat,
      longitude: userB.birthLng,
    },
  });

  return {
    score: result.compatibility.score,      // 0-100
    label: result.compatibility.label,      // "harmonious"
    harmony: result.compatibility.harmony,  // ważona suma
    tension: result.compatibility.tension,
  };
}

Wskazówka

Wynik synastrii jest niezmienny (zależy tylko od dat urodzenia). Zbuforuj parę (userA_id, userB_id) → wynik w swojej bazie danych. Jedno wywołanie API — i nie musisz już więcej przeliczać.

Szacowanie budżetu

Scenariusz: 1 000 nowych dopasowań dziennie

Metryka	Wartość
Dopasowań/dzień	1 000
Kredytów/dopasowanie	50 (synastry)
Kredytów/dzień	50 000
Kredytów/miesiąc	~1 500 000
Taryfa	Business ($199/mies., 3 500 000 kredytów)

Scenariusz: 50 dopasowań dziennie (startup)

Metryka	Wartość
Dopasowań/dzień	50
Kredytów/dzień	2 500
Kredytów/miesiąc	~75 000
Taryfa	Starter ($19/mies., 200 000 kredytów)

Optymalizacja

• Buforowanie — przechowuj wynik w bazie danych, nie przeliczaj ponownie
• Leniwe przetwarzanie — obliczaj synastrię tylko wtedy, gdy użytkownik otwiera dopasowanie, a nie dla wszystkich potencjalnych par
• Pakietowe obliczenia podczas rejestracji — oblicz kompatybilność z top 20 potencjalnych dopasowań od razu

Brak godziny urodzenia

Jeśli użytkownik nie zna godziny — przekaż "time": "12:00:00" (południe). Domówki będą mniej dokładne, ale pozycje planetarne i krzyżowe aspekty będą poprawne. Wynik kompatybilności pozostanie informatywny.

Dla kompatybilności HD czas jest ważniejszy — rozważ użycie hd/sensitivity do oceny wpływu niedokładnego czasu.

Synastry API → Szczegółowe informacje o endpointach kompatybilności

Szybki start Pierwsze zapytanie w 5 minut

Cennik Od darmowego do Enterprise