Magento B2B API

guest-carts/{cartId}/items

POST

/V1/guest-carts/{cartId}/items

Add/update the specified cart item.

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///V1/guest-carts//items' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cartItem": {
        "extension_attributes": {
            "negotiable_quote_item": {
                "extension_attributes": {},
                "item_id": 0,
                "original_discount_amount": 0,
                "original_price": 0,
                "original_tax_amount": 0
            }
        },
        "item_id": 0,
        "name": "string",
        "price": 0,
        "product_option": {
            "extension_attributes": {
                "bundle_options": [
                    {
                        "extension_attributes": {},
                        "option_id": 0,
                        "option_qty": 0,
                        "option_selections": [
                            0
                        ]
                    }
                ],
                "configurable_item_options": [
                    {
                        "extension_attributes": {},
                        "option_id": "string",
                        "option_value": 0
                    }
                ],
                "custom_options": [
                    {
                        "extension_attributes": {
                            "file_info": {
                                "base64_encoded_data": "string",
                                "name": "string",
                                "type": "string"
                            }
                        },
                        "option_id": "string",
                        "option_value": "string"
                    }
                ],
                "downloadable_option": {
                    "downloadable_links": [
                        0
                    ]
                },
                "giftcard_item_option": {
                    "custom_giftcard_amount": 0,
                    "extension_attributes": {},
                    "giftcard_amount": "string",
                    "giftcard_message": "string",
                    "giftcard_recipient_email": "string",
                    "giftcard_recipient_name": "string",
                    "giftcard_sender_email": "string",
                    "giftcard_sender_name": "string"
                }
            }
        },
        "product_type": "string",
        "qty": 0,
        "quote_id": "string",
        "sku": "string"
    }
}'

响应示例

200 - 示例 1

{
    "extension_attributes": {
        "negotiable_quote_item": {
            "extension_attributes": {},
            "item_id": 0,
            "original_discount_amount": 0,
            "original_price": 0,
            "original_tax_amount": 0
        }
    },
    "item_id": 0,
    "name": "string",
    "price": 0,
    "product_option": {
        "extension_attributes": {
            "bundle_options": [
                {
                    "extension_attributes": {},
                    "option_id": 0,
                    "option_qty": 0,
                    "option_selections": [
                        0
                    ]
                }
            ],
            "configurable_item_options": [
                {
                    "extension_attributes": {},
                    "option_id": "string",
                    "option_value": 0
                }
            ],
            "custom_options": [
                {
                    "extension_attributes": {
                        "file_info": {
                            "base64_encoded_data": "string",
                            "name": "string",
                            "type": "string"
                        }
                    },
                    "option_id": "string",
                    "option_value": "string"
                }
            ],
            "downloadable_option": {
                "downloadable_links": [
                    0
                ]
            },
            "giftcard_item_option": {
                "custom_giftcard_amount": 0,
                "extension_attributes": {},
                "giftcard_amount": "string",
                "giftcard_message": "string",
                "giftcard_recipient_email": "string",
                "giftcard_recipient_name": "string",
                "giftcard_sender_email": "string",
                "giftcard_sender_name": "string"
            }
        }
    },
    "product_type": "string",
    "qty": 0,
    "quote_id": "string",
    "sku": "string"
}

请求参数

Path 参数

cartId

string

必需

Body 参数application/json

cartItem

object (quote-data-cart-item-interface)

必需

Interface CartItemInterface

extension_attributes

object (quote-data-cart-item-extension-interface)

可选

ExtensionInterface class for @see \Magento\Quote\Api\Data\CartItemInterface

item_id

integer

可选

Item ID. Otherwise, null.

name

string

可选

Product name. Otherwise, null.

price

number

可选

Product price. Otherwise, null.

product_option

object (quote-data-product-option-interface)

可选

Product option interface

product_type

string

可选

Product type. Otherwise, null.

qty

number

必需

Product quantity.

quote_id

string

Quote id.

必需

sku

string

可选

Product SKU. Otherwise, null.

示例

返回响应

🟢200成功

application/json

200 Success.

Body

Interface CartItemInterface

extension_attributes

object (quote-data-cart-item-extension-interface)

可选

ExtensionInterface class for @see \Magento\Quote\Api\Data\CartItemInterface

negotiable_quote_item

object (negotiable-quote-data-negotiable-quote-item-interface)

可选

Interface CompanyQuoteConfigInterface

item_id

integer

可选

Item ID. Otherwise, null.

name

string

可选

Product name. Otherwise, null.

price

number

可选

Product price. Otherwise, null.

product_option

object (quote-data-product-option-interface)

可选

Product option interface

extension_attributes

object (quote-data-product-option-extension-interface)

可选

ExtensionInterface class for @see \Magento\Quote\Api\Data\ProductOptionInterface

product_type

string

可选

Product type. Otherwise, null.

qty

number

必需

Product quantity.

quote_id

string

Quote id.

必需

sku

string

可选

Product SKU. Otherwise, null.

🟠400请求有误

🔴500服务器错误

修改于 2024-11-22 03:29:06

guest-carts/{cartId}/items

guest-carts/{cartId}/items/{itemId}