Restomenum Geliştirici
Giriş yapKayıt ol

Hızlı Başlangıç

İlk eklentini uçtan uca ayağa kaldırmak için en kısa yol. Her adım, kodun bulunduğu detay sayfasına bağlanır — bu sayfa yalnızca sırayı verir. Kavramsal harita için önce Mimari & Kavramlar'a göz at.

Kuş bakışı: Mimari & Kavramlar.

1) Eklenti + manifest oluştur

Portalda yeni eklenti aç; manifest'i doldur: hangi scope'ları istediğin, abone olacağın event'ler, eklemek istediğin UI sayfaları/butonlar/hook'lar.

Endpoint'lerin tek domain altında olmalı: webhookUrl, connectUrl, actionUrl ve UI origin'leri aynı registered domain (tek-apex).

2) Client secret üret

Eklenti sayfasında client_secret üret (bir kez gösterilir, sakla). OAuth Connect exchange'i bunu ister. (Sürüm oluşturmadan önce gerekir.)

3) Kurulum akışını bağla — Connect + Token Exchange

Tenant eklentini kurarken: OAuth Connect → dönen code'u Token Exchange ile değiştir → tenant başına sakla: tenantId, apiKey, webhookSecret, scopes. (Kod örnekleri o sayfalarda.)

4) Webhook alıcını kur + imzayı doğrula

Tek bir /webhook ucu hem event'leri hem lifecycle'ı alır. Gelen her istekte imzayı (HMAC) ham gövde üzerinden doğrula; geçersizse 401 dön. id ile dedup uygula (retry'da tekrar gelir).

5) Veri API'sini çağır

Token exchange'teki apiKey ile mağaza verisini oku (API Uçları):

Gerçek çağrı (sandbox)
# Test mağazasındaki install API key ile (token exchange çıktısı)
curl -H "Authorization: Bearer <serverId>.<pluginId>.<secret>" \
  https://sandbox.plugins.restomenum.app/plugin-api/products/list

Yazma gerekiyorsa packets/create (orders:write).

6) (Opsiyonel) Arayüz + akış kontrolü ekle

7) Test et → yayınla