İstek
| Parça | Değer |
|---|---|
| Yöntem ve adres | POST https://isortagimgiris.pazarama.com/connect/token |
| Authorization | Basic base64(API_KEY:API_SECRET) |
| Content-Type | application/x-www-form-urlencoded |
| Gövde | grant_type=client_credentials&scope=merchantgatewayapi.fullaccess |
Basic başlık RFC 7617'deki yöntemdir: iki değer araya iki nokta konarak birleştirilir ve Base64 ile kodlanır. Kimlik sunucusunun yapılandırma belgesi, istemci kimliğini hem Basic başlıkta (client_secret_basic) hem form gövdesinde (client_secret_post) kabul ettiğini bildirir. Gövde JSON değil, form biçimindedir; OAuth2 token isteği RFC 6749'a göre bu biçimi kullanır.
Yanıt
Canlıda çalışan entegrasyon token'ı Pazarama'nın sarmalı içinden okur: data nesnesinde accessToken ve expiresIn, üst seviyede success alanı. Standart OAuth2 adları olan access_token ve expires_in da yedek olarak denenir. Kodunuz iki biçimi de okuyabilmelidir.
| Alan | Yedek ad | Anlamı |
|---|---|---|
| data.accessToken | access_token | Bearer olarak gönderilecek değer |
| data.expiresIn | expires_in | Saniye cinsinden geçerlilik süresi |
| success | - | İşlem başarılı mı |
Yanıtta accessToken bulunmuyorsa token alınmamış sayılmalıdır; boş bir değerle API isteği atmayın.
Token'ı aldıktan sonra expiresIn değerinden bir bitiş zamanı hesaplayıp token'la birlikte saklayın. Böylece her istekte süre kontrolü yaparsınız ve gereksiz yere yeni token istemezsiniz. Token'ın nasıl saklanıp yenileneceği token süresi ve yenileme sayfasında.
Kapsam (scope) değerleri
Kimlik sunucusunun herkese açık yapılandırma belgesi pazaryeri servisleri için üç kapsam listeler.
| Kapsam | Durum |
|---|---|
| merchantgatewayapi.fullaccess | Canlı entegrasyon bununla çalışıyor; ürün, stok, fiyat ve sipariş servislerine erişiyor |
| merchantgatewayapi.read | Belgede listeli; hangi servisleri açtığı doğrulanamadı |
| merchantgatewayapi.write | Belgede listeli; hangi servisleri açtığı doğrulanamadı |
Tek bir okuma aracı yazıyorsanız read kapsamını denemek mantıklı olabilir, ama davranışını önce test edin.
Kapsam, token'ın hangi servislere erişebileceğini belirler. Gereğinden geniş kapsam istemek güvenlik açısından ideal değildir; örneğin yalnız sipariş raporu alan bir araç için yazma yetkisi gerekmez. Ancak dar kapsamların Pazarama'da hangi servisleri açtığı doğrulanamadığından, canlıda kesin çalışan seçenek fullaccess'tir.
Kimlik sunucusu bilgileri
| Bilgi | Değer |
|---|---|
| issuer | https://isortagimgiris.pazarama.com |
| token_endpoint | https://isortagimgiris.pazarama.com/connect/token |
| Desteklenen akışlardan biri | client_credentials |
| İstemci kimliği yöntemleri | client_secret_basic, client_secret_post |
| Ek uç noktalar | revocation (iptal), introspect (doğrulama) |
Bu bilgiler OpenID Connect Discovery standardındaki yapılandırma belgesinden okunur. Adresi koda gömmek yerine belgeden okumak, ileride değişirse işinizi kolaylaştırır.
Sık hatalar ve çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
| 400 ya da 401 | Key ya da Secret yanlış veya süresi dolmuş | Panelden değerleri kontrol edin |
| 400, gövde okunamıyor | Gövde JSON gönderilmiş | x-www-form-urlencoded kullanın |
| Token geliyor ama API 401 veriyor | Bearer öneki unutulmuş | Authorization: Bearer TOKEN yazın |
| Yanıtta token bulunamıyor | Sarmal biçim beklenmemiş | data içini ve standart adları birlikte okuyun |
| Her istekte yeni token | Önbellek yok | Token'ı süresi dolana kadar saklayın |
Sık sorulanlar
Pazarama token adresi nedir?
POST https://isortagimgiris.pazarama.com/connect/token. Adres, kimlik sunucusunun yapılandırma belgesinde token_endpoint olarak da yazar.
Pazarama API hangi scope ile çalışır?
Canlıda çalışan entegrasyon merchantgatewayapi.fullaccess kapsamını kullanır. Belgede ayrıca merchantgatewayapi.read ve merchantgatewayapi.write kapsamları listelenir.
Token isteği JSON ile mi gönderilir?
Hayır. Gövde application/x-www-form-urlencoded biçiminde gönderilir: grant_type=client_credentials&scope=merchantgatewayapi.fullaccess.
API Key ve Secret Basic başlıkta mı gönderilir?
Canlı entegrasyon Basic başlığı kullanır. Kimlik sunucusu belgesine göre değerler form gövdesinde (client_secret_post) de gönderilebilir.
Kaynaklar
İlgili Pazarama API konuları
Son güncelleme: 27.10.2026 · Pazarama API rehberinin tamamı