🎁 Ton 1er RDV beauté à -10% · code BIENVENUE10
— Développeurs

API NAILORA v1.

API REST publique en lecture seule. JSON, CORS ouvert, sans authentification.

Base URL : https://nailora.fr/api/v1
Rate limit : 60 req/min/IP

GET /api/v1/artists

Liste des artistes.

Query params (tous optionnels) :

  • city — filtre par ville (ex. ?city=Paris)
  • style — filtre par style (ex. ?style=Chrome)
  • q — recherche full-text français
  • limit — max 100, défaut 24
  • offset — pagination
curl https://nailora.fr/api/v1/artists?city=Paris&style=Chrome&limit=10

GET /api/v1/artists/:slug

Détail d'une artiste (avec services + photos).

curl https://nailora.fr/api/v1/artists/camille-b

GET /api/v1/styles

Liste des 5 styles : Nail Art, Gel, Chrome, Minimal, French.

GET /api/v1/cities

Liste des villes couvertes (triées par nombre d'artistes).

Réponse type

{
  "data": [
    {
      "id": 1,
      "slug": "camille-b",
      "name": "Camille B.",
      "city": "Paris",
      "style": "Nail Art",
      "rating": 4.9,
      "reviews_count": 142,
      "price_from": 55,
      "photo_main": "https://...",
      "url": "https://nailora.fr/artiste/camille-b"
    }
  ],
  "pagination": { "total": 42, "limit": 24, "offset": 0, "has_more": true }
}

Status codes

  • 200 — OK
  • 404 — Ressource introuvable
  • 429 — Rate limit dépassé

Cas d'usage

Cette API est faite pour :

  • Indexation Google/Bing (déjà accessible)
  • Partenaires B2B (Treatwell-like, agrégateurs beauté)
  • Apps tierces (extensions navigateur, widgets)
  • Recherche sémantique IA (Perplexity, ChatGPT plugins)

Limitations

Pas d'écriture. Pas d'accès aux bookings/users/données privées. Pour ces besoins, contact : [email protected].