# Vastu API : plan de la maison, mandala, 16 zones, rapport

Tu envoies un plan de maison : le contour, l'angle par rapport au nord, les pièces, les objets et la porte principale, en pixels d'une image ou en mètres. En retour, tu reçois où se trouve chaque pièce par rapport au centre, ce que les textes en disent, ce qui peut être fait et une image que tu peux superposer directement sur le plan.

![Mandala de 81 cellules superposé sur un plan de 12 sur 9 mètres : cuisine au sud-est, toilettes au nord-est, porte dans la pada E3](/vastu-plan-overlay.svg)

## Ce que l'API retourne

| Endpoint | Crédits | Ce que ça retourne |
|---|---|---|
| `POST /v1/vastu/plan` | 20 | Pour chaque pièce et objet, l'azimut, les secteurs 8, 16 et 32, la cellule du mandala avec la divinité, le verdict avec la source ; la pada de la porte ; la forme du contour ; les découvertes avec les corrections ; l'évaluation avec la bande |
| `POST /v1/render/vastu` | 20 | SVG dans les coordonnées du plan avec un fond transparent : mandala, 16 zones ou 8 directions |
| `POST /v1/reports/vastu` | 5 000 | Rapport PDF sous ta marque, en ukrainien ou en anglais |
| `POST /v1/vastu/zones` | 10 | 8, 16 ou 32 secteurs avec des limites précises et, si un plan est fourni, ce qui se trouve dans chaque zone |
| `POST /v1/vastu/rooms` | 10 | Verdict et évaluation par directions, si le plan a déjà été mesuré |
| `POST /v1/vastu/entrance` | 10 | Pada de la porte principale et sa conséquence |
| `POST /v1/vastu/mandala` | 10 | Le mandala entier : 45 divinités et leurs cellules |
| `POST /v1/vastu/directions` | 10 | Huit directions avec les gardiens, les planètes et les règles classiques |

Description complète des champs, exemples et codes d'erreur : [documentation Vastu](/vedic/vastu/).

## D'où viennent les règles

Chaque verdict a une `basis`. `classical` signifie qu'un verset le sous-tend, et la source en indique le numéro : **Brihat Samhita, chapitre 53** (traduction d'Ayer de 1884, le sanskrit a été vérifié pour la forme du terrain), **Mayamatam** pour la deuxième école classique, **Muhurta Chintamani 12.21** pour les pièces des seize zones. `convention` signifie une pratique moderne sans verset, et c'est ainsi que c'est écrit.

Trois écoles au choix : `brihat-samhita` (par défaut), `mayamata` et `sixteen-zone`. Les écoles classiques calculent les azimuts à partir du centre du rectangle du mandala, l'école des seize zones à partir du centroïde de la surface ; la réponse indique toujours à partir de quel point.

**Caution:**
**Certaines pièces sont rejetées par les écoles classiques.** La salle à manger, le balcon, le garage et le réservoir sur le toit n'ont pas de règle classique, donc `brihat-samhita` et `mayamata` retournent 400, et non une réponse inventée. Dans l'école `sixteen-zone`, elles sont évaluées, avec la mention `convention`.

## Ce que nous ne faisons pas

- **Nous ne lisons pas le plan à partir d'une image.** Tu transmets toi-même la géométrie, donc l'image du plan avec son adresse ne quitte pas ton appareil : seules les coordonnées du contour, des pièces et des portes nous parviennent.
- **Nous ne promettons pas de résultat.** Les corrections ont une complexité et une indication si elles peuvent être annulées, mais aucune ne garantit que quelque chose changera. Nous ne proposons pas de produits : pyramides, yantras, figurines.
- **Nous n'inventons pas de règles.** Un emplacement non couvert par aucune source a un verdict `no-rule` et n'est pas inclus dans l'évaluation.

## À qui s'adresse ceci

- **Proptech et agences immobilières** : évaluation du plan d'un appartement à côté d'autres caractéristiques du bien.
- **Architectes et designers d'intérieur** : vérification d'un croquis selon les règles classiques avant même les dessins.
- **Consultants Vastu** : un rapport sous leur propre marque en une minute au lieu d'un calcul manuel.
- **Plateformes astrologiques** : Vastu à côté de la carte, avec la même clé et les mêmes crédits.

## Questions

**Comment définir le nord si je n'ai qu'une boussole ?** Transmets l'angle, `northReference: "magnetic"` et la `declination` pour ton emplacement. Sans déclinaison, ce sera 400 : les règles sont lues à partir du vrai nord.

**Qu'en est-il d'un plan en forme de L ?** Son centroïde se trouve en dehors du plan. La réponse avertit à ce sujet, les écoles classiques calculent à partir du centre du rectangle du mandala, et les cellules dans la découpe sont marquées `outsideContour`.

**Combien coûte un rapport ?** 5 000 crédits, comme les autres rapports PDF. Les rapports ne sont pas disponibles avec le forfait gratuit ; les calculs à 10 et 20 crédits le sont.