Rozpoczęcie pracy z NumerologyAPI¶

Niniejszy przewodnik przeprowadzi Cię przez:

• tworzenie konta dla programistów
• generowanie klucza API
• zrozumienie uwierzytelniania
• wykonywanie pierwszego żądania API

NumerologyAPI udostępnia ponad 203 gotowe do użycia punkty końcowe, obejmujące:

• obliczenia numerologiczne
• wglądy astrologiczne
• kompatybilność znaków
• liczby anielskie
• interpretacje horoskopu urodzeniowego

Wszystkie punkty końcowe obsługują odpowiedzi wielojęzyczne.

1. Utwórz swoje konto dla programistów¶

Zalecany sposób dostępu do NumerologyAPI to poprzez oficjalną platformę dla programistów.

1. Otwórz panel programisty https://dashboard.numerologyapi.com

2. Utwórz swoje konto

3. Wygeneruj klucz API dla swojej organizacji

4. Dopełnij saldo w portfelu (płatność za zużycie)

Twój klucz API będzie wyglądał podobnie:

tnea_xxxxxxxxxxxxxxxxx

2. Podstawowy adres URL¶

Wszystkie żądania są wysyłane do bramy NumerologyAPI.

Przykład punktu końcowego:

https://api.numerologyapi.com/api/v1/life_path

3. Autentykacja¶

Każde żądanie musi zawierać Twój klucz API.

x-api-key: YOUR_API_KEY

Przykładowe nagłówki żądań:

GET /api/v1/life_path HTTP/1.1
Host: api.numerologyapi.com
x-api-key: YOUR_API_KEY

4. Pierwsze Żądanie – Liczba Ścieżki Życia¶

Żądanie GET¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  --header "x-api-key: YOUR_API_KEY"

5. Wariant POST (Ciało JSON)¶

Niektóre punkty końcowe obsługują również żądania POST.

curl --request POST \
  --url https://api.numerologyapi.com/api/v1/life_path \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
  }'

6. Obsługa Języków¶

Wszystkie punkty końcowe obsługują opcjonalny parametr lang.

Przykład:

?lang=fr

Obsługiwane języki:

Przykład żądania:

/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=es

7. Przykłady Kodu¶

Python (requests)¶

import requests

url = "https://api.numerologyapi.com/api/v1/life_path"

params = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

PHP (cURL)¶

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

?>

JavaScript (Fetch)¶

const url = new URL("https://api.numerologyapi.com/api/v1/life_path");

url.searchParams.append("birth_year", "1990");
url.searchParams.append("birth_month", "5");
url.searchParams.append("birth_day", "15");

fetch(url, {
    method: "GET",
    headers: {
        "x-api-key": "YOUR_API_KEY"
    }
})
.then(r => r.json())
.then(console.log);

Node.js (axios)¶

const axios = require("axios");

axios.get("https://api.numerologyapi.com/api/v1/life_path", {
  params: {
    birth_year: 1990,
    birth_month: 5,
    birth_day: 15
  },
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
.then(res => console.log(res.data));

8. Model Płatności¶

NumerologyAPI wykorzystuje system płatności oparty na kredytach.

1 API request = 1 credit
1 USD = 3,921.57 credits

Kredyty są dzielone między wszystkie ponad 200 punktów końcowych.

Odwiedź stronę Ceny, aby uzyskać szczegółowe informacje.

9. Dostęp przez RapidAPI¶

Numerology API jest również dostępne na RapidAPI dla deweloperów, którzy już korzystają z tego rynku.

RapidAPI wymaga następujących nagłówków:

x-rapidapi-key
x-rapidapi-host

Przykład endpointu:

https://the-numerology-api.p.rapidapi.com/life_path

Dostęp do niego znajduje się tutaj:

https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api

10. Kolejne kroki¶

Teraz, gdy wykonałeś swój pierwszy żądanie:

• Zapoznaj się z Dokumentacją API dla wszystkich endpointów
• Przejrzyj Ceny, aby zrozumieć zasoby
• Sprawdź Log zmian w celu uzyskania aktualizacji

Teraz możesz zintegrować NumerologyAPI ze swoim aplikacją.