Introducere la NumerologyAPI¶

Acest ghid vă ghidează prin:

• crearea unui cont de dezvoltator
• generarea unei chei API
• înțelegerea autentificării
• efectuarea primei cereri API

NumerologyAPI oferă peste 203 endpoint-uri pregătite pentru producție, care acoperă:

• calcule numerologice
• perspective astrologice
• compatibilitate zodiacală
• numere angelice
• interpretări ale horoscopului

Toți endpoint-urile suportă răspunsuri în mai multe limbi.

1. Creați contul dvs. de dezvoltator¶

Calea recomandată pentru a accesa NumerologyAPI este prin platforma oficială pentru dezvoltatori.

1. Deschideți panoul de control al dezvoltatorului https://dashboard.numerologyapi.com

2. Creați contul

3. Generați o cheie API pentru organizația dvs.

4. Adăugați credite în portofel (facturare pe bază de utilizare)

Cheia dvs. API va arăta similar cu:

tnea_xxxxxxxxxxxxxxxxx

2. URL-ul de bază¶

Toate cererile sunt trimise către gateway-ul NumerologyAPI.

Exemplu endpoint:

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

3. Autentificare¶

Fiecare cerere trebuie să includă cheia API.

x-api-key: YOUR_API_KEY

Exemple de header-e ale cererii:

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

4. Prima Cerere – Numărul Cale al Vieții¶

Cerere 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. Variantă POST (Corp JSON)¶

Unele endpoint-uri suportă și cereri 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. Suport pentru Limbi¶

Toate endpoint-urile suportă parametrul opțional lang.

Exemplu:

?lang=fr

Limbaje suportate:

Exemplu de cerere:

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

7. Exemple de Cod¶

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 de Facturare¶

NumerologyAPI folosește un sistem de facturare bazat pe credite.

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

Creditele sunt împărțite între toate cele 203+ endpoint-uri.

Vizitați Prețuri pentru detalii complete.

9. Acces prin RapidAPI¶

API-ul Numerology este, de asemenea, disponibil pe RapidAPI pentru dezvoltatorii care utilizează deja acest marketplace.

RapidAPI necesită următoarele header-e:

x-rapidapi-key
x-rapidapi-host

Exemplu endpoint:

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

Accesați-l aici:

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

10. Pași Următori¶

Acum că ați efectuat prima solicitare, puteți:

• Explora Referința API pentru toți endpoint-urile
• Revizuiți Prețuri pentru a înțelege creditele
• Verificați Logul de modificări pentru actualizări

Acum sunteți pregătiți să integrați NumerologyAPI în aplicația dumneavoastră.