API Reference

Ürün Güncelleme Örnek İstek

Örnek İstek

Örnek istek Amazon mağazasında bulunan YNG-WTR-3 stok kodlu ürünün; hakkında, açıklama, ana ürün görseli, diğer ürün görseli, stok adedi ve fiyat bilgilerini güncelleyecek şekilde kurgulanmıştır.

curl -L -X PATCH 'https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/AO0WPKWDI17JQ/YNG-WTR-3?marketplaceIds=A33AVAJ2PDY3EV' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \ntial=ASIAUZLEGP75K4UK2ON6/20230114/eu-west-1/execute-api/aws4_request, SignedHeaders=host;x-amz-access-token;x-amz-content-sha256;x-amz-date;x-amz-security-token, Signature=bd133d77616d8a95a4eb11e45e52d2b1dc2ce5b2d7a4be5295bb20796c8ff38f' \
-H 'Content-Type: application/json' \
--data-raw '{
    "productType": "PRODUCT",
    "patches": [
        {
            "op": "replace",
            "path": "/attributes/bullet_point",
            "value": [
                {
                    "value": "Belirli oranda geri dönüştürülmüş malzemelerle üretilen, konforlu koşu ayakkabısı."
                }
            ]
        },
        {
            "op": "replace",
            "path": "/attributes/product_description",
            "value": [
                {
                    "value": "Her zaman kullanabileceğin bu koşu ayakkabısı, bazı yenilikçi teknolojilerle donatılmıştır."
                }
            ]
        },
        {
            "op": "replace",
            "path": "/attributes/main_product_image_locator",
            "value": [
                {
                    "media_location": "https://amazon-seller-central-tr.s3.eu-central-1.amazonaws.com/shoe-1.jpgı"
                }
            ]
        },
        {
            "op": "replace",
            "path": "/attributes/other_product_image_locator_1",
            "value": [
                {
                    "media_location": "https://amazon-seller-central-tr.s3.eu-central-1.amazonaws.com/shoe-2.jpg"
                }
            ]
        },
        {
            "op": "replace",
            "path": "/attributes/fulfillment_availability",
            "value": [
                {
                    "fulfillment_channel_code": "DEFAULT",
                    "quantity": "100"
                }
            ]
        },
        {
            "op": "replace",
            "path": "/attributes/purchasable_offer",
            "value": [
                {
                    "currency": "TRY",
                    "our_price": [
                        {
                            "schedule": [
                                {
                                    "value_with_tax": 97
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}'
{
    "sku": "YNG-WTR-3",
    "status": "ACCEPTED",
    "submissionId": "30cb3461696142f2bbbb5d4a36a55db6",
    "issues": []
}
{
    "sku": "YNG-WTR-3",
    "status": "INVALID",
    "submissionId": "cdb8a9ae08ad4f76912cdb96394bcda2",
    "issues": [
        {
            "code": "90000900",
            "message": "Özellikler geçersiz.",
            "severity": "ERROR",
            "attributeNames": [
                "fulfillment_availability2"
            ]
        },
        {
            "code": "90000900",
            "message": "Özellikler geçersiz.",
            "severity": "ERROR",
            "attributeNames": [
                "bullet_point2"
            ]
        },
        {
            "code": "90000900",
            "message": "Özellikler geçersiz.",
            "severity": "ERROR",
            "attributeNames": [
                "main_product_image_locator2"
            ]
        },
        {
            "code": "90000900",
            "message": "Özellikler geçersiz.",
            "severity": "ERROR",
            "attributeNames": [
                "other_product_image_locator_12"
            ]
        },
        {
            "code": "90000900",
            "message": "Özellikler geçersiz.",
            "severity": "ERROR",
            "attributeNames": [
                "purchasable_offer2"
            ]
        }
    ]
}

Ürüne Mevcut Özellik Bilgisini Güncelleme

Örnek istek, Amazon mağazasında bulunan YNG-WTR-3 stok kodlu ürünün; özellik bilgilerini güncelleyecek şekilde kurgulanmıştır.

  • Stil (style): "Spor"

📘

Özellikler, ürün türüne göre değişkenlik göstermektedir. Ekleyeceğiniz ürünün özelliklerine, ürün türü özellik metodu ile erişebilirsiniz.
curl -L -X PATCH 'https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/AO0WPKWDI17JQ/YNG-WTR-3?marketplaceIds=A33AVAJ2PDY3EV' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \ntial=ASIAUZLEGP75K4UK2ON6/20230114/eu-west-1/execute-api/aws4_request, SignedHeaders=host;x-amz-access-token;x-amz-content-sha256;x-amz-date;x-amz-security-token, Signature=bd133d77616d8a95a4eb11e45e52d2b1dc2ce5b2d7a4be5295bb20796c8ff38f' \
-H 'Content-Type: application/json' \
--data-raw '{
    "productType": SHOES,
    "patches": [
        {
            "op": "add",
            "path": "/attributes/style",
            "value": [
                {
                    "value": "Spor"
                }
            ]
        }
    ]
}'

Ürüne Yeni Özellik Ekleme

Örnek istek Amazon mağazasında bulunan YNG-WTR-3 stok kodlu ürüne; yeni özellik eklenecek şekilde kurgulanmıştır.

  • Model İsmi (model_name): Runner

📘

Özellikler, ürün türüne göre değişkenlik göstermektedir. Ekleyeceğiniz ürünün özelliklerine, ürün türü özellik metodu ile erişebilirsiniz.
curl -L -X PATCH 'https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/AO0WPKWDI17JQ/YNG-WTR-3?marketplaceIds=A33AVAJ2PDY3EV' \
-H 'x-amz-access-token: {{access-token}}' \
-H 'X-Amz-Security-Token: {{security-token}}' \
-H 'X-Amz-Date: {{request-date}}' \
-H 'Authorization: {{authorization}}' \ntial=ASIAUZLEGP75K4UK2ON6/20230114/eu-west-1/execute-api/aws4_request, SignedHeaders=host;x-amz-access-token;x-amz-content-sha256;x-amz-date;x-amz-security-token, Signature=bd133d77616d8a95a4eb11e45e52d2b1dc2ce5b2d7a4be5295bb20796c8ff38f' \
-H 'Content-Type: application/json' \
--data-raw '{
    "productType": SHOES,
    "patches": [
        {
            "op": "add",
            "path": "/attributes/model_name",
            "value": [
                {
                    "value": "Runner"
                }
            ]
        }
    ]
}'

Doldurulması Gereken Güvenlik Parametreleri

Örnek isteği gönderip sonuç alabilmeniz için istek içerisinde bulunan ve aşağıda listesi verilen parametreleri doldurmanız gerekmektedir.

Güvenlik Parametreleri
{{access-token}}
{{security-token}}
{{request-date}}
{{authorization}}