MCP, script veya harici entegrasyon için üç bilgi gerekir: müşteri kodu (GUID), API kullanıcısı (sistem kullanıcısı) ve JWT token. Adımlar Admin API (/api/v5/ad) içindir.
1Müşteri kodunu (GUID) alın
Sağ üst profil menüsünde Müşteri Kodu → kopyala. Tüm isteklerde
GUIDheader’ında kullanın.2API için sistem kullanıcısı oluşturun
3Token alın (login)
→
data.token4İlk istek: ürün listesi
5Ortam değişkenleri (örnek)
Ajans / entegrasyon rehberi
Admin panel entegrasyonları, back-office, raporlama, operasyon API’leri. Bu liste Admin (AD) — 440 endpoint. Parametreler ve açıklamalar backend OpenAPI’sinden üretilir; soldan uç seçin veya ⌘K ile arayın.
Bu site (service.kommerz.io) Vercel’de env tanımlamadan çalışır. Prod/Beta/Test URL’leri uygulama içinde sabittir. Env yalnızca farklı bir API hostu kullanacaksanız gereklidir (opsiyonel).
Kimlik doğrulama
- 1. `POST /auth/login` — Header: tenant GUID. Body: `userName`, `password`. Yanıt: `data.token` (JWT).
- 2. Sonraki istekler: `Authorization: Bearer {token}` + aynı GUID header’ları.
- 3. Token süresi dolunca `POST /auth/refresh` (panel akışı ile uyumlu).
Ortam adresleri (env gerekmez)
- Prod https://rigelapi.kommerz.io/api/v5/ad
- Beta https://rigelapi-beta.kommerz.io/api/v5/ad
- Test https://rigelapi-test.kommerz.io/api/v5/ad
- Tenant (mağaza) kodu header’da gider: `GUID`, `Guid`, `guid` veya vitrinde `X-GUID` — hepsi aynı müşteri kodunu taşır. Admin paneldeki “müşteri kodu” ile aynıdır.
- JSON isteklerde `Content-Type: application/json; charset=utf-8` kullanın (Türkçe karakter için).
- Çoğu uç `status` (boolean), `data` (yük), `message` sarmalayıcısı döner. Hata durumunda HTTP 4xx/5xx + gövdede mesaj bekleyin.
- Dokümandaki cURL örnekleri `$MUSTERI_GUID` ve `$ACCESS_TOKEN` placeholder kullanır; kendi değerlerinizle değiştirin.
- Modüller: Sipariş (v2), order-edit, ürün v2, muhasebe, depo, marketplace-integrations, kullanıcı, ayarlar (`/common/constants`, bulk_constant).
Admin - Accounting Integration
Admin - Accounting Integration — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Authentication
Panel girişi, system-users, token yenileme.
Admin - Bank Accounts
Admin - Bank Accounts — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Banks
Admin - Banks — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - BinList
Admin - BinList — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Call Center
Admin - Call Center — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Campaign
Admin - Campaign — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Cargo
Admin - Cargo — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Cart
Admin - Cart — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Common
Site sabitleri (constants), bulk_constant, Redis yenileme.
Admin - Content Pages
Admin - Content Pages — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Coupon
Admin - Coupon — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Forms
Admin - Forms — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Imports
Admin - Imports — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Influencer
Admin - Influencer — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Media
Admin - Media — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Notification
Admin - Notification — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Order
Sipariş listesi, detay, durum, adres ve operasyon uçları.
Admin - Order Edit
Sipariş düzenleme, onay, ek maliyet, ürün arama.
Admin - Payment
Admin - Payment — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Payment Options
Admin - Payment Options — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Product
Ürün CRUD, v2 detay, paket, arama, import/export.
Admin - Report
Admin - Report — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - Services
Admin - Services — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Admin - User
Admin - User — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
SF - Marketplace Integration
SF - Marketplace Integration — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.
Warehouse
Warehouse — Rigel v5 `/api/v5/ad`. Parametreler ve gövde şeması OpenAPI ile üretilir; canlı yanıt için Test ortamında deneyin.