API Reference

Dosya Gönderim Kontrolü Örnek İstek

Örnek İstek

Örnek istek içerisinde Sipariş numarası 404-9749393-3785910 olan siparişe gönderilebilecek mesajların tiplerini döndürür.

📘

Başarılı cevap içerisinde _links > actions > name parametresi sendInvoice içeriyorsa fatura gönderimi yapabilirsiniz.

📘

Başarılı cevap içerisinde _links > actions > name parametresi legalDisclosure içeriyorsa dosya gönderimi yapabilirsiniz.
curl -L 'https://sellingpartnerapi-eu.amazon.com/messaging/v1/orders/404-9749393-3785910?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}}' \
{
    "_links": {
        "actions": [
            {
                "href": "/messaging/v1/orders/404-9749393-3785910/messages/legalDisclosure?marketplaceIds=A33AVAJ2PDY3EV",
                "name": "legalDisclosure"
            },
            {
                "href": "/messaging/v1/orders/404-9749393-3785910/messages/negativeFeedbackRemoval?marketplaceIds=A33AVAJ2PDY3EV",
                "name": "negativeFeedbackRemoval"
            },
            {
                "href": "/messaging/v1/orders/404-9749393-3785910/messages/unexpectedProblem?marketplaceIds=A33AVAJ2PDY3EV",
                "name": "unexpectedProblem"
            },
            {
                "href": "/messaging/v1/orders/404-9749393-3785910/messages/sendInvoice?marketplaceIds=A33AVAJ2PDY3EV",
                "name": "sendInvoice"
            }
        ],
        "self": {
            "href": "/messaging/v1/orders/404-9749393-3785910?marketplaceIds=A33AVAJ2PDY3EV"
        }
    },
    "_embedded": {
        "actions": [
            {
                "_links": {
                    "schema": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/legalDisclosure/schema",
                        "name": "legalDisclosure"
                    },
                    "self": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/legalDisclosure?marketplaceIds=A33AVAJ2PDY3EV",
                        "name": "legalDisclosure"
                    }
                },
                "_embedded": {
                    "schema": {
                        "_links": {
                            "self": {
                                "href": "/messaging/v1/orders/404-9749393-3785910/messages/legalDisclosure/schema",
                                "name": "legalDisclosure"
                            }
                        },
                        "type": "object",
                        "name": "legalDisclosure",
                        "title": "Send necessary legal disclosures",
                        "description": "Send disclosures needed to meet legal requirements in your country.",
                        "properties": {
                            "attachments": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "required": [],
                                    "properties": {
                                        "fileName": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "title": "Add attachment",
                                "description": "You can upload text files, PDFs, Word documents, and these image file types: .jpg, .gif, and .png. The total size of attachments must be less than 10 MB.",
                                "x-ui-field-type": "attachments",
                                "minItems": 1,
                                "maxItems": 5
                            }
                        },
                        "required": [
                            "attachments"
                        ],
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "x-ui-hidden": null
                    }
                },
                "name": "legalDisclosure",
                "title": "Send necessary legal disclosures"
            },
            {
                "_links": {
                    "schema": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/negativeFeedbackRemoval/schema",
                        "name": "negativeFeedbackRemoval"
                    },
                    "self": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/negativeFeedbackRemoval?marketplaceIds=A33AVAJ2PDY3EV",
                        "name": "negativeFeedbackRemoval"
                    }
                },
                "_embedded": {
                    "schema": {
                        "_links": {
                            "self": {
                                "href": "/messaging/v1/orders/404-9749393-3785910/messages/negativeFeedbackRemoval/schema",
                                "name": "negativeFeedbackRemoval"
                            }
                        },
                        "type": "object",
                        "name": "negativeFeedbackRemoval",
                        "title": "Request to update negative feedback",
                        "description": "Ask your customer to consider updating their seller feedback rating. You may only send this once per order.",
                        "properties": {},
                        "required": [],
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "x-ui-hidden": true
                    }
                },
                "name": "negativeFeedbackRemoval",
                "title": "Request to update negative feedback"
            },
            {
                "_links": {
                    "schema": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/unexpectedProblem/schema",
                        "name": "unexpectedProblem"
                    },
                    "self": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/unexpectedProblem?marketplaceIds=A33AVAJ2PDY3EV",
                        "name": "unexpectedProblem"
                    }
                },
                "_embedded": {
                    "schema": {
                        "_links": {
                            "self": {
                                "href": "/messaging/v1/orders/404-9749393-3785910/messages/unexpectedProblem/schema",
                                "name": "unexpectedProblem"
                            }
                        },
                        "type": "object",
                        "name": "unexpectedProblem",
                        "title": "Notify of a problem with shipping your order",
                        "description": "Notify your customer there was an unexpected problem with shipping their order.",
                        "properties": {
                            "rawMessageBody": {
                                "type": "string",
                                "title": "Explain why you are contacting and any action you need your customer to take. ",
                                "description": "2000 character limit. Only links related to order completion are allowed, no HTML or email addresses.",
                                "x-ui-field-type": "text",
                                "minLength": 1,
                                "maxLength": 2000
                            }
                        },
                        "required": [
                            "rawMessageBody"
                        ],
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "x-ui-hidden": null
                    }
                },
                "name": "unexpectedProblem",
                "title": "Notify of a problem with shipping your order"
            },
            {
                "_links": {
                    "schema": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/sendInvoice/schema",
                        "name": "sendInvoice"
                    },
                    "self": {
                        "href": "/messaging/v1/orders/404-9749393-3785910/messages/sendInvoice?marketplaceIds=A33AVAJ2PDY3EV",
                        "name": "sendInvoice"
                    }
                },
                "_embedded": {
                    "schema": {
                        "_links": {
                            "self": {
                                "href": "/messaging/v1/orders/404-9749393-3785910/messages/sendInvoice/schema",
                                "name": "sendInvoice"
                            }
                        },
                        "type": "object",
                        "name": "sendInvoice",
                        "title": "Send invoice",
                        "description": "Send the customer an invoice for the order.",
                        "properties": {
                            "attachments": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "required": [],
                                    "properties": {
                                        "fileName": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "string"
                                        }
                                    }
                                },
                                "title": "Add attachment",
                                "description": "You can upload text files, PDFs, Word documents, and these image file types: .jpg, .gif, and .png. The total size of attachments must be less than 10 MB.",
                                "x-ui-field-type": "attachments",
                                "minItems": 1,
                                "maxItems": 5
                            }
                        },
                        "required": [
                            "attachments"
                        ],
                        "$schema": "http://json-schema.org/draft-04/schema#",
                        "x-ui-hidden": null
                    }
                },
                "name": "sendInvoice",
                "title": "Send invoice"
            }
        ]
    }
}
{
    "errors": [
        {
            "code": "InvalidInput",
            "message": "Failed validation because order 406-8089906-9117150 is EasyShip.",
            "details": ""
        }
    ]
}

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}}