Aller au contenu

Premiers Pas avec NumerologyAPI

Ce guide vous accompagne étape par étape pour :

  • créer un compte développeur
  • générer une clé API
  • comprendre l'authentification
  • effectuer votre première requête API

NumerologyAPI propose plus de 203 endpoints prêts pour la production couvrant :

  • calculs de numérologie
  • insights d'astrologie
  • compatibilité zodiacale
  • nombres angéliques
  • interprétations du thème natal

Tous les endpoints prennent en charge des réponses multilingues.

1. Créez Votre Compte Développeur

La façon recommandée d'accéder à NumerologyAPI est via la plateforme officielle pour développeurs.

  1. Ouvrez le tableau de bord développeur https://dashboard.numerologyapi.com

  2. Créez votre compte

  3. Générez une clé API pour votre organisation

  4. Rechargez des crédits dans votre portefeuille (facturation à l'usage)

Votre clé API ressemblera à :

tnea_xxxxxxxxxxxxxxxxx

2. URL de Base

Toutes les requêtes sont envoyées à la passerelle NumerologyAPI.

Élément Valeur
URL de Base https://api.numerologyapi.com/api/v1
Protocole HTTPS
Format de Réponse JSON

Exemple d'endpoint :

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

3. Authentification

Chaque requête doit inclure votre clé API.

x-api-key: VOTRE_CLE_API

Exemple d'en-têtes de requête :

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

4. Première Requête – Numéro de Chemin de Vie

Requête 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: VOTRE_CLE_API"

5. Variante POST (Corps JSON)

Certains endpoints prennent également en charge les requêtes POST.

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

6. Support des Langues

Tous les endpoints prennent en charge le paramètre optionnel lang.

Exemple :

?lang=fr

Langues prises en charge :

Code Langue
en Anglais
es Espagnol
de Allemand
fr Français
pt Portugais

Exemple de requête :

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

7. Exemples de Code

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": "VOTRE_CLE_API"
}

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: VOTRE_CLE_API"
  ],
]);

$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": "VOTRE_CLE_API"
    }
})
.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": "VOTRE_CLE_API"
  }
})
.then(res => console.log(res.data));

8. Modèle de Facturation

NumerologyAPI utilise un système de facturation basé sur des crédits.

1 requête API = 1 crédit
1 USD = 3 921,57 crédits

Les crédits sont partagés entre tous les plus de 203 endpoints.

Consultez Tarifs pour tous les détails.

9. Accès via RapidAPI

L'API de Numérologie est également disponible sur RapidAPI pour les développeurs utilisant déjà cette marketplace.

RapidAPI requiert ces en-têtes :

x-rapidapi-key
x-rapidapi-host

Exemple d'endpoint :

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

Accédez-y ici :

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

10. Prochaines Étapes

Maintenant que vous avez effectué votre première requête :

Vous êtes maintenant prêt à intégrer NumerologyAPI dans votre application.