- 🦊一分钟，了解 Apifox ！
- 示例项目
- Orders
- Product Tags
- Auth
- Customers
- Product Collections
- Return Reasons
- Product Categories
- Product Types
- Products
- Product Variants
- Shipping Options
- Regions
- Carts
- Gift Cards
- Swaps
- Order Edits
- Payment Collections
- Returns
- 11111POST
- 数据模型
- 示例数据模型
- Schemas
- StorePostOrderEditsOrderEditDecline
- StorePostCartsCartLineItemsReq
- StorePostCustomersCustomerOrderClaimReq
- StorePostCartsCartPaymentSessionReq
- StorePostCartsCartLineItemsItemReq
- StorePaymentCollectionSessionsReq
- StoreCustomersListPaymentMethodsRes
- Response Error
- StorePostPaymentCollectionsBatchSessionsAuthorizeReq
- StorePostCartReq
- StorePostSwapsReq
- StorePostSearchReq
- StoreGetAuthEmailRes
- Multiple Errors
- StorePostCustomersCustomerAcceptClaimReq
- StorePostCustomersResetPasswordReq
- StorePostCartsCartShippingMethodReq
- StorePostReturnsReq
- Product Collection
- StoreCollectionsListRes
- AddressPayload
- StorePostCustomersCustomerAddressesAddressReq
- Product Category
- StoreGetProductCategoriesCategoryRes
- StorePostAuthReq
- StorePostCustomersReq
- Return Reason
- StoreReturnReasonsListRes
- Gift Card Transaction
- Currency
- StorePostSearchRes
- Product Tag
- StoreProductTagsListRes
- StorePostCustomersCustomerPasswordTokenReq
- Shipping Method Tax Line
- Country
- Address
- Tax Provider
- Payment Provider
- Fulfillment Provider
- Customer Group
- StorePostCartsCartPaymentSessionUpdateReq
- Discount Rule
- StorePostCartsCartReq
- Line Item Tax Line
- Customer
- StoreAuthRes
- Sales Channel Stock Location
- Sales Channel
- StoreCustomersRes
- StoreCollectionsRes
- Shipping Option Requirement
- StoreGetProductCategoriesRes
- Shipping Profile
- Shipping Option
- Shipping Method
- StorePostPaymentCollectionsBatchSessionsReq
- Product Type
- StoreProductTypesListRes
- Payment
- StoreReturnReasonsRes
- AddressCreatePayload
- StorePostCustomersCustomerAddressesReq
- Product Variant Inventory Item
- Product Option Value
- Image
- Money Amount
- Product Variant
- StorePostCustomersCustomerReq
- Product Option
- Product
- Tax Rate
- Region
- Discount
- Priced Product Variant
- StoreVariantsListRes
- StoreCustomersResetPasswordRes
- StoreVariantsRes
- Priced Shipping Option
- StoreCartShippingOptionsListRes
- Gift Card
- Priced Product
- StoreProductsListRes
- StoreShippingOptionsListRes
- StoreProductsRes
- Line Item Adjustment
- Line Item
- StoreRegionsRes
- Cart
- StoreCartsRes
- StoreGiftCardsRes
- StoreRegionsListRes
- Swap
- StoreSwapsRes
- Order
- StoreOrdersRes
- Order Item Change
- StoreCompleteCartRes
- Payment Session
- Payment Collection
- Order Edit
- StoreOrderEditsRes
- StoreCustomersListOrdersRes
- StorePaymentCollectionsRes
- Return Item
- Return
- StoreReturnsRes
- StorePaymentCollectionsSessionRes
Get Gift Card by Code
GET
/store/gift-cards/{code}
请求参数
Path 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl '{backend_url}/store/gift-cards/{code}'
返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"gift_card": {
"id": "gift_01G8XKBPBQY2R7RBET4J7E0XQZ",
"code": "3RFT-MH2C-Y4YZ-XMN4",
"value": 10,
"balance": 10,
"region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"order_id": "order_01G8TJSYT9M6AVS5N4EMNFS1EK",
"order": {},
"is_disabled": false,
"ends_at": "2019-08-24T14:15:22.123Z",
"tax_rate": 0,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
},
"region": {
"id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"name": "EU",
"tax_rate": 0,
"tax_code": null,
"gift_cards_taxable": true,
"automatic_taxes": true,
"tax_provider_id": null,
"includes_tax": false,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"currency_code": "usd",
"metadata": {
"car": "white"
},
"tax_provider": {
"id": "manual",
"is_installed": true
},
"payment_providers": [
{
"id": "manual",
"is_installed": true
}
],
"countries": [
{
"id": 109,
"name": "ITALY",
"display_name": "Italy",
"region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"region": {},
"iso_2": "it",
"iso_3": "ita",
"num_code": 380
}
],
"fulfillment_providers": [
{
"id": "manual",
"is_installed": true
}
],
"currency": {
"symbol": "$",
"symbol_native": "$",
"name": "US Dollar",
"includes_tax": false,
"code": "usd"
},
"tax_rates": [
{
"id": "txr_01G8XDBAWKBHHJRKH0AV02KXBR",
"rate": 10,
"code": "tax01",
"name": "Tax Example",
"region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"region": {},
"product_count": 10,
"product_type_count": 2,
"shipping_option_count": 1,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
},
"product_types": [
{
"id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
"value": "Clothing",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
}
],
"products": [
{
"id": "prod_01G1G5V2MBA328390B5AXJ610F",
"title": "Medusa Coffee Mug",
"subtitle": "string",
"description": "Every programmer's best friend.",
"handle": "coffee-mug",
"is_giftcard": false,
"thumbnail": "http://example.com",
"profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
"weight": null,
"length": null,
"height": null,
"width": null,
"hs_code": null,
"origin_country": null,
"mid_code": null,
"material": null,
"collection_id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
"type_id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
"discountable": true,
"external_id": null,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"status": "draft",
"metadata": {
"car": "white"
},
"tags": [
{
"id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
"value": "Pants",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
}
],
"images": [
{
"id": "img_01G749BFYR6T8JTVW6SGW3K3E6",
"url": "http://example.com",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
}
],
"categories": [
{
"id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
"name": "Regular Fit",
"handle": "regular-fit",
"mpath": "pcat_id1.pcat_id2.pcat_id3",
"is_internal": false,
"is_active": false,
"rank": 0,
"parent_category_id": null,
"parent_category": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"category_children": [
{}
],
"products": [
{}
]
}
],
"collection": {
"id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
"title": "Summer Collection",
"handle": "summer-collection",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"products": [
{}
],
"metadata": {
"car": "white"
}
},
"sales_channels": [
{
"id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
"name": "Market",
"description": "Multi-vendor market",
"is_disabled": false,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
},
"locations": [
{
"id": "scloc_01G8X9A7ESKAJXG2H0E6F1MW7A",
"sales_channel_id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
"location_id": "string",
"sales_channel": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z"
}
]
}
],
"type": {
"id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
"value": "Clothing",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
},
"variants": [
{
"id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
"title": "Small",
"product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
"product": {},
"sku": "shirt-123",
"barcode": null,
"ean": null,
"upc": null,
"variant_rank": 0,
"inventory_quantity": 100,
"allow_backorder": false,
"manage_inventory": true,
"hs_code": null,
"origin_country": null,
"mid_code": null,
"material": null,
"weight": null,
"length": null,
"height": null,
"width": null,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"purchasable": true,
"metadata": {
"car": "white"
},
"inventory_items": [
{
"id": "pvitem_01G8X9A7ESKAJXG2H0E6F1MW7A",
"inventory_item_id": "string",
"variant_id": "string",
"variant": {},
"required_quantity": 1,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z"
}
],
"prices": [
{
"id": "ma_01F0YESHRFQNH5S8Q0PK84YYZN",
"amount": 100,
"min_quantity": 1,
"max_quantity": 1,
"price_list_id": "pl_01G8X3CKJXCG5VXVZ87H9KC09W",
"price_list": {},
"variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
"variant": {},
"region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"region": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"currency_code": "usd",
"currency": {
"symbol": "$",
"symbol_native": "$",
"name": "US Dollar",
"includes_tax": false,
"code": "usd"
}
}
],
"options": [
{
"id": "optval_01F0YESHR7S6ECD03RF6W12DSJ",
"value": "large",
"option_id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
"option": {},
"variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
"variant": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
}
]
}
],
"options": [
{
"id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
"title": "Size",
"product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
"product": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
},
"values": [
{
"id": "optval_01F0YESHR7S6ECD03RF6W12DSJ",
"value": "large",
"option_id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
"option": {},
"variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
"variant": {},
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"metadata": {
"car": "white"
}
}
]
}
],
"profile": {
"id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
"name": "Default Shipping Profile",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"type": "default",
"products": [
{}
],
"shipping_options": [
{}
],
"metadata": {
"car": "white"
}
},
"profiles": [
{
"id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
"name": "Default Shipping Profile",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"type": "default",
"products": [
{}
],
"shipping_options": [
{}
],
"metadata": {
"car": "white"
}
}
]
}
],
"shipping_options": [
{
"id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
"name": "PostFake Standard",
"region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
"region": {},
"profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
"provider_id": "manual",
"amount": 200,
"is_return": false,
"admin_only": false,
"includes_tax": false,
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"price_type": "flat_rate",
"data": {},
"metadata": {
"car": "white"
},
"requirements": [
{
"id": "sor_01G1G5V29AB4CTNDRFSRWSRKWD",
"shipping_option_id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
"shipping_option": {},
"amount": 100,
"deleted_at": "2019-08-24T14:15:22.123Z",
"type": "min_subtotal"
}
],
"provider": {
"id": "manual",
"is_installed": true
},
"profile": {
"id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
"name": "Default Shipping Profile",
"created_at": "2019-08-24T14:15:22.123Z",
"updated_at": "2019-08-24T14:15:22.123Z",
"deleted_at": "2019-08-24T14:15:22.123Z",
"type": "default",
"products": [
{}
],
"shipping_options": [
{}
],
"metadata": {
"car": "white"
}
}
}
]
}
]
}
}
}🟠400请求有误
🟠404记录不存在
🟠409409
🟠422参数错误
🔴500服务器错误
修改于 2025-07-10 01:25:19