API Postman Kuralları

Postman, HTTP isteklerini oluşturmak, göndermek ve analiz etmek için kullanıcı dostu bir arayüz sağlayarak Merchant API'lerini test etme ve anlama olanağını önemli ölçüde artırır. Farklı uç noktalara yönelik çeşitli API çağrılarını (GET, POST, PUT, DELETE) kolayca oluşturup değiştirebilir, parametreleri, başlıkları ve istek gövdelerini ayarlayarak gerçek dünya senaryolarını simüle edebilirsiniz.

Durum kodları, başlıklar ve yükler dahil olmak üzere yanıtların net bir şekilde sunulması, API davranışının hızlıca doğrulanmasına ve sorunların ayıklanmasına yardımcı olur. Bu yapılandırılmış yaklaşım, geliştirme yaşam döngüsünü hızlandırır, API kalitesini artırır ve Merchant API'nin özelliklerinin ve karmaşıklıklarının daha iyi anlaşılmasını sağlar.

Genel Bakış

Postman örneğinizde MAPI Postman koleksiyonunu kullanmak için önce ortamı yapılandırmak üzere birkaç adımı uygulamanız gerekir. Bu işlemi nasıl yapacağınızla ilgili adım adım açıklamalı kılavuzu aşağıda bulabilirsiniz.

Platform hakkında daha fazla bilgi için Postman açıklamasına bakın.

1. Hizmet hesabı yapılandırması

serviceAccountKey ve api_key değerlerini alırsınız.

  1. Ayrıntılı adımlar için API'ye erişmek için hizmet hesabı kullanma başlıklı makaleyi inceleyin.
  2. Google Cloud projeniz > Kimlik bilgileri > Kimlik bilgileri oluştur > Hizmet hesabı
  3. Formu doldurun ve Oluştur ve devam et'i tıklayın.
  4. Sahip rolünü seçin ve Devam'ı tıklayın.
  5. Bitti'yi tıklayın
  6. JSON anahtarını indirmek için aşağıdaki adımları uygulayın:
    1. Yeni oluşturulan hizmet hesabı e-posta adresini (örneğin, {YOUR_SERVICE_ACCOUNT}@{RANDOM_DOMAIN}.gserviceaccount.com) tıklayın.
    2. Anahtarlar sekmesini tıklayın.
    3. Anahtar ekle > Anahtar oluştur'u tıklayın.
    4. JSON'ı seçin ve JSON'ı indirmek için Oluştur'u tıklayın.

UYARI: Anahtarı yalnızca bir kez indirebilirsiniz. Anahtarı kaybederseniz yeni bir anahtar oluşturmanız ve bu anahtarı silmeniz gerekir.

  1. Merchant Center'ı açın.
  2. Ayarlar > Erişim ve hizmet bölümünde Kişiler ve erişim'i tıklayın.
  3. Kişi ekle'yi tıklayın ve yeni kullanıcı için e-posta adresi olarak hizmet hesabı kimliğini kullanın.

2. Postman kurulumu

  1. Postman Environment template JSON dosyasını indirin.
  2. MAPI Postman koleksiyonu JSON'unu indirin.
  3. Postman'de oturum açın veya yeni bir hesap oluşturun.
  4. Postman Environment şablonunu içe aktarma
    1. Tam JSON'unuzu Environment > MyAccount > serviceAccountKey'e kopyalayın.
    2. JSON'daki private_key değerini kopyalayıp koleksiyonun Environment > MyAccount > api_key bölümüne yapıştırın.
  5. MAPI Postman Collection JSON'ı içe aktarma
  6. Sağ üst köşedeki ortamı seçin.

3. Geliştirici kaydı

Geliştirici olarak kaydolarak Merchant Center hesabınızı Google Cloud projesine bağlayın. API geliştirici rolüne sahip kullanıcılar, zorunlu hizmet duyuruları, geliştirici anketleri ve fırsatlar dahil olmak üzere API iletişimi alır.

  1. Postman > Collections > Merchant API Official'ı açın.
  2. accounts_v1 > accounts > accounts.developerRegistration > registerGcp'yi açın.
  3. Yoldaki {account} yer tutucusunu MC kimliğinizle değiştirin.
  4. Gövdedeki {email} yer tutucusunu e-posta adresinizle değiştirin.
  5. Kaydı gerçekleştirmek için Gönder'i tıklayın.
  6. Her şey doğru şekilde yapıldıysa aşağıdaki gibi bir onay JSON yanıtı alırsınız: json { "name": "accounts/{YOUR_MC_ID}/developerRegistration", "gcpIds": [ "{YOUR_GCP_ID}" ] }

4. Postman'de Merchant API'yi test etme

  1. Postman > Collections > Merchant API Official > accounts_v1 > accounts > list'i açın.
  2. Gönder'i tıklayın.
  3. Her şey doğru şekilde yapıldıysa aşağıdaki gibi bir onay JSON yanıtı alırsınız: json { "accounts": [ { "name": "accounts/{YOUR_MC_ID}", "accountId": "{YOUR_MC_ID}", "accountName": "{YOUR_MERCHANT_NAME}", "adultContent": false, "timeZone": { "id": "{YOUR_TIMEZONE}" }, "languageCode": "en-US" } ] }