Développeurs

L'API Domaria

Connectez Domaria à vos autres outils (ERP, CRM, tableurs, Zapier/Make/n8n…) : lisez vos indicateurs et vos biens, créez des contacts — avec un jeton personnel révocable.

Lecture (KPIs agrégés, biens) et création de contacts (idempotente). Aucune action sensible ou destructrice ne passe par l'API.

Obtenir un jeton

Depuis votre espace de travail Domaria : Réglages → Branchements → API. Générez un jeton (affiché une seule fois), copiez-le, et utilisez-le dans l'en-tête Authorization. Vous pouvez le révoquer à tout moment depuis la même page.

URL de base

https://app.domaria.fr/api/v1

En-tête d'authentification

Authorization: Bearer dmk_…

Endpoints

  • GET /api/v1/pingteste la connexion — renvoie votre agence et les droits du jeton
  • GET /api/v1/kpis?days=30vos statistiques d'activité sur la période (jours)
  • GET /api/v1/propertiesla liste de vos biens
  • POST /api/v1/contactscrée un contact (idempotent par email) — « remplir le CRM »

Exemple

curl -H "Authorization: Bearer dmk_…" https://app.domaria.fr/api/v1/ping

Réponse attendue :

{
  "ok": true,
  "tenant": {
    "organizationId": "…",
    "agencyId": "…"
  },
  "scopes": [
    "kpis:read"
  ]
}