Geliştiriciler

Glanevo Public API.

REST + JSON, OAuth 2.0, webhooks. Salon iş akışını programatik yönet — randevu, müşteri, ödeme, raporlar.

OpenAPI spec ↗Developer portalı →API makaleleri →

Hızlı başlangıç

Adım 1

API key oluştur

Panel → Ayarlar → Geliştiriciler → Yeni Key. Scope seç (read / write / admin).

Adım 2

Authorization header

Her request'te Bearer token gönder.

curl https://api.glanevo.com/v1/appointments \
  -H "Authorization: Bearer sk_live_xxx"

Adım 3

Webhook kur

Real-time olay için HTTPS endpoint kaydet. Signature ile doğrula.

Base URL & versioning

Tüm endpoint'ler https://api.glanevo.com/v1 base URL'inde. Versioning URL'de — breaking değişiklikler /v2/ ile gelir, eski versiyon en az 12 ay desteklenir.

Rate limit. Pro: 100 req/saat. Premium: 1000 req/saat. Enterprise: özel. X-RateLimit-Remaining header'ından kalan budget'ı izle.

Authentication

İki yetkilendirme yöntemi:

API Key — sunucu-sunucu işlemler için. Authorization: Bearer sk_live_...
OAuth 2.0 — kullanıcı adına işlem (3rd party app). Authorization Code Grant + refresh token.

Sık kullanılan endpoint'ler

Method	Path	Açıklama
GET	/v1/appointments	Randevu listesi (filter: from, to, staff, customer)
POST	/v1/appointments	Yeni randevu oluştur
GET	/v1/appointments/:id	Tek randevu detayı
PATCH	/v1/appointments/:id	Randevu güncelle (saat, personel, durum)
DELETE	/v1/appointments/:id	Randevu iptal et
GET	/v1/customers	Müşteri listesi (filter, paginate)
POST	/v1/customers	Yeni müşteri oluştur
PUT	/v1/services/:id	Hizmet güncelle
GET	/v1/staff	Personel listesi
GET	/v1/payments	Ödeme geçmişi
POST	/v1/payments/refund	İade işle
GET	/v1/reports/daily	Günlük Z rapor JSON

Kod örneği — yeni randevu oluştur

curl

curl -X POST https://api.glanevo.com/v1/appointments \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_01H...",
    "serviceId": "svc_01H...",
    "staffId": "stf_01H...",
    "startAt": "2026-05-22T14:00:00Z"
  }'

node

import { Glanevo } from "@glanevo/sdk";

const glanevo = new Glanevo({
  apiKey: process.env.GLANEVO_KEY!,
});

const appt = await glanevo.appointments.create({
  customerId: "cus_01H...",
  serviceId: "svc_01H...",
  staffId: "stf_01H...",
  startAt: "2026-05-22T14:00:00Z",
});

console.log(appt.id);

Webhooks

Olay olduğunda Glanevo sizin belirlediğiniz HTTPS adresine bildirim gönderir. Signature ile doğrula, 2xx döndür — yoksa 5x exponential backoff retry.

appointment.created

appointment.updated

appointment.cancelled

appointment.no_show

customer.created

customer.updated

payment.succeeded

payment.failed

payment.refunded

invoice.created

invoice.paid

staff.created

Resmi SDK'lar

Node.js / TypeScript

stable

v1.x

npm install @glanevo/sdk

Python

beta

v0.4

pip install glanevo

PHP

alpha

v0.1

composer require glanevo/sdk

Diğer dillerde REST API her dilde çalışır; community SDK için github.com/glanevo/sdk'a PR aç.

Geliştirici desteği

Slack topluluğuna katıl.

Sorular, örnekler, beta API'ler. Glanevo ekip burada.

Slack davet linki ↗Developer portalı →