Introduzione a NumerologyAPI¶

Questa guida ti guiderà attraverso:

• la creazione di un account per sviluppatori
• la generazione di una chiave API
• la comprensione dell'autenticazione
• l'esecuzione della tua prima richiesta API

NumerologyAPI fornisce oltre 203 endpoint pronte all'uso, che coprono:

• calcoli numerologici
• approfondimenti astrologici
• compatibilità zodiacale
• numeri angelici
• interpretazioni del grafico natale

Tutti gli endpoint supportano risposte multilingue.

1. Crea il Tuo Account per Sviluppatori¶

Il modo consigliato per accedere a NumerologyAPI è tramite la piattaforma ufficiale per sviluppatori.

1. Apri il pannello di controllo dello sviluppatore https://dashboard.numerologyapi.com

2. Crea il tuo account

3. Genera una chiave API per la tua organizzazione

4. Ricarica i crediti nel tuo portafoglio (fatturazione a consumo)

La tua chiave API assomiglierà a:

tnea_xxxxxxxxxxxxxxxxx

2. URL di Base¶

Tutte le richieste vengono inviate al gateway NumerologyAPI.

Esempio endpoint:

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

3. Autenticazione¶

Ogni richiesta deve includere la tua chiave API.

x-api-key: YOUR_API_KEY

Esempio di intestazioni della richiesta:

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

4. Prima Richiesta – Numero del Life Path¶

Richiesta 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. Richiesta POST (Corpo JSON)¶

Alcuni endpoint supportano anche le richieste 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. Supporto Linguistico¶

Tutti gli endpoint supportano il parametro opzionale lang.

Esempio:

?lang=fr

Lingue supportate:

Esempio di richiesta:

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

7. Esempi di Codice¶

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. Modello di Fatturazione¶

NumerologyAPI utilizza un sistema di fatturazione basato su crediti.

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

I crediti sono condivisi tra tutti i 203+ endpoint.

Per maggiori dettagli, consultare Prezzi.

9. Accesso tramite RapidAPI¶

L'API Numerology è disponibile anche su RapidAPI per gli sviluppatori che utilizzano già questo marketplace.

RapidAPI richiede le seguenti intestazioni:

x-rapidapi-key
x-rapidapi-host

Esempio di endpoint:

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

Accedetelo qui:

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

10. Passi Successivi¶

Ora che avete effettuato la vostra prima richiesta:

• Esplorate la Riferimento API per tutti gli endpoint
• Rivedete i Prezzi per comprendere i crediti
• Consultate il Log delle modifiche per gli aggiornamenti

Ora siete pronti ad integrare NumerologyAPI nella vostra applicazione.