Guide de demarrage FreeAstroAPI

Il vous faut un dossier de projet, un terminal, un outil de code avec IA comme Codex, Cursor, Claude Code ou Antigravity, et environ 10 minutes. La cle sera stockee cote serveur sous le nom FREE_ASTRO_API_KEY.

1. Ouvrir le dashboard FreeAstroAPI

Creez un compte gratuit si vous n'en avez pas encore :

Creer un compte gratuit

Apres connexion, ouvrez le dashboard :

Ouvrir le dashboard

Si vous etes deja connecte depuis la page d'accueil, cliquez sur Dashboard en haut a droite :

2. Creer votre cle API

Dans le dashboard, ouvrez API Keys depuis la barre laterale.

API Keys

Cliquez sur Create New Key.

Donnez un nom simple a la cle, par exemple :

Local development

Quand la cle est creee, copiez-la tout de suite. La cle complete n'est affichee qu'une fois.

Gardez-la pour l'etape suivante. Ne la committez pas dans Git.

3. Enregistrer la cle en prive

La plupart des projets Next.js utilisent un fichier .env.local a la racine du projet. La racine est le dossier qui contient package.json.

Creez ou modifiez .env.local, puis ajoutez :

FREE_ASTRO_API_KEY=paste_your_real_key_here

Redemarrez le serveur de developpement apres avoir ajoute la cle.

Si votre projet n'est pas une app Next.js, utilisez le fichier d'environnement prive de votre framework. Il peut s'appeler .env, .env.local ou autrement.

Utilisez ces faits API exacts dans chaque requete FreeAstroAPI :

• Base URL: https://api.freeastroapi.com
• API key header: x-api-key
• Private env var: FREE_ASTRO_API_KEY
• First endpoint: POST /api/v1/natal/calculate

Ne creez pas de variable NEXT_PUBLIC_FREE_ASTRO_API_KEY. Tout ce qui commence par NEXT_PUBLIC_ peut etre expose aux visiteurs dans certaines apps frontend.

Si vous ne savez pas ou placer les variables d'environnement, demandez ceci a votre assistant IA :

I am using FreeAstroAPI.
Please inspect my project and tell me where private server-side environment variables should go.
Use the variable name FREE_ASTRO_API_KEY.
Do not ask me to paste the full key into this chat.
Tell me the exact filename, the exact folder, and whether I need to restart my app.
Explain this in simple beginner language.

4. Tester la cle une fois

Avant de developper une fonctionnalite, faites une requete de test.

Dans un terminal local, definissez la cle pour cette session :

export FREE_ASTRO_API_KEY="paste_your_real_key_here"

Puis lancez :

curl -X POST "https://api.freeastroapi.com/api/v1/natal/calculate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $FREE_ASTRO_API_KEY" \
  -d '{
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 10,
    "minute": 30,
    "city": "New York",
    "lat": 40.7128,
    "lng": -74.006,
    "tz_str": "America/New_York"
  }'

Une requete valide retourne du JSON astrologique. Si vous voyez 401, la cle manque, est invalide ou n'est pas envoyee dans le header x-api-key.

5. Donner les faits API a votre assistant IA

Une fois la cle enregistree et le test valide, collez ce prompt dans Codex, Cursor, Claude ou ChatGPT :

I want to use FreeAstroAPI in this project.

Use this API base URL:
https://api.freeastroapi.com

Use this private server-side environment variable:
FREE_ASTRO_API_KEY

Authentication:
- Send the key in the x-api-key header.
- Send Content-Type: application/json for POST requests.

Safety rules:
- Keep the key on the server.
- Do not put the key in browser code.
- Do not print the full key in logs.
- Do not create a NEXT_PUBLIC_* variable for the key.

First endpoint:
POST /api/v1/natal/calculate

Please create the smallest server-side helper that calls FreeAstroAPI with fetch, handles non-200 responses, and returns the parsed JSON.
Explain each file you change in beginner language.

Si l'assistant vous demande de coller la cle complete dans le chat, refusez. Il doit lire la cle depuis votre fichier d'environnement local.

6. Construire votre premiere fonctionnalite

Quand le helper fonctionne, demandez une premiere fonctionnalite simple :

The FreeAstroAPI connection test works.

Now help me create a simple first feature for my app:
- Ask the user for birth date, birth time, and birth city.
- Send that information to my own server first.
- From the server, call FreeAstroAPI using FREE_ASTRO_API_KEY.
- Show the result in a beginner-friendly way.

Please keep this simple and explain each step before changing files.

L'assistant aura assez de contexte pour choisir les bons fichiers sans exposer la cle.

7. Corriger les problemes frequents

Si l'app dit que la cle manque :

My app says FREE_ASTRO_API_KEY is missing.
Please help me check whether the environment file is in the right place.
Do not ask me to paste the full key.
Tell me whether I need to restart my development server.

Si l'assistant place la cle dans le frontend :

Stop. The FreeAstroAPI key must stay private.
Please move the API call to a server-side place in this project and explain the safer structure in simple language.

Si la requete API echoue :

My FreeAstroAPI request failed.
Please help me debug it step by step.
Check the API base URL, the private environment variable name, and whether the request is being made from the server.
Do not print or expose my full API key.

8. Checklist finale de securite

• Gardez la cle API complete privee.
• Ne la collez pas dans des chats publics, captures d'ecran, issues GitHub ou code frontend.
• Utilisez le nom FREE_ASTRO_API_KEY.
• Redemarrez l'app apres ajout ou modification de la cle.
• Si une cle fuit, supprimez-la dans le dashboard et creez-en une nouvelle.

9. A lire ensuite

• Documentation d'authentification
• Gerer les cles API
• Documentation de l'API theme natal