Geliştirici Dokümantasyonu

Public REST API (v1)

MarkaGüveni platformunun verilerine erişmek, firmanızın yorumlarını ve puanlarını kendi uygulamanıza entegre etmek veya otomatik müşteri yorumu davetiyesi oluşturmak için REST API uç noktalarımızı kullanabilirsiniz.

API Kimlik Doğrulama (Authentication)

Tüm API isteklerinize Bearer Token veya X-API-KEY başlığı (Header) eklemelisiniz.

Authorization: Bearer mg_live_9f8d7a6b5c4e3d2a1...

API Endpoints (Uç Noktalar)

GET /api/v1/companies

Aktif kayıtlı tüm firmaları listeler. Arama sorgusu desteği: ?search=trendyol

GET /api/v1/companies/{id}

Belirli bir firmanın puanını, sektörünü ve son 10 müşteri yorumunu döndürür.

GET /api/v1/reviews

Platformdaki veya firmaya ait yayınlanmış yorumları listeler. Parametre: ?company_id=1

POST /api/v1/invitations

Müşterinize e-posta adresi ve ismiyle otomatik yorum yapma davetiyesi gönderir.

GET /api/v1/widgets

Firmanıza ait aktif widget jetonlarını (tokens) listeler.