Close
  • Category

  • Product

  • Personal

  • API Index

    non-print

    Introduction

    Cafe24 API

    Cafe24 Shopping Mall API is an API provided to app store join developers and third-party solution providers to provide services related to shopping malls.

    Cafe24 API is a RESTful architecture that provides OAuth 2.0 based authentication system, a standard HTTP request method, a predictable endpoint URL, and an HTTP code based error message.

    Request/Response Format

    • API request and response support JSON format.

    • For privacy protection purposes, Cafe 24 API only supports HTTPS protocol.

    • Dates properties are provided in the ISO_8601 format. : YYYY-MM-DDTHH:MM:SS + 09:00

    Request Example (search)

    (function(CAFE24API) { 
      CAFE24API.get('{endpoint_url}', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      '{endpoint_url}' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("{endpoint_url}")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "{endpoint_url}"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: '{endpoint_url}',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => '{endpoint_url}',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "{endpoint_url}"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Request Example (register/modify)

    (function(CAFE24API) { 
      var data = { .... };
    
      CAFE24API.post('{endpoint_url}', data, function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X POST \
      '{endpoint_url}' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}' \
      -d '{ .... }'
    
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{ .... }");
    
    Request request = new Request.Builder()
      .url("{endpoint_url}")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .post(body)
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "{endpoint_url}"
    
    payload = '''{ .... }'''
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("POST", url, data=payload, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var payload = { .... };
    
    var options = { method: 'POST',
      url: '{endpoint_url}',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      },
      body: payload,
      json: true
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $data = '{ .... }';
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => '{endpoint_url}',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => $data,
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
        "strings"
    )
    
    func main() {
        url := "{endpoint_url}"
    
        payload := strings.NewReader(`{ .... }`)
    
        req, _ := http.NewRequest("POST", url, payload)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Right response example

    {
        "resource": {
            "key": "value",
            "key": "value"
         }
    }
    

    Error response example

    {
        "error": {
            "code": "error code",
            "message": "error message",
            "more_info": {
            }
        }
    }
    

    Method

    Each resources support Create, Read, Update, and Delete and API can be used by using standard HTTP method.

    • POST : Create the resource.

    • GET: Read data the resource.

    • PUT : Modify(Update) the resource.

    • DELETE : Delete (delete) the resource.

    Front API Intro

    Front API

    Front API is suitable for public information(displayed product information) or for customer to get their own information or write at a board. Front API is limited for some informations compare to Admin API.

    example

    https://{mallid}.cafe24api.com/api/v2/sampleapi
    

    API Status Code

    Code Case Solutions
    200 When GET success, PUT success, DELETE success
    201 When POST success
    207 When status is vary as requested multiple objects. Checks the error status of each object and deal with errors according to its status.
    400 Server does not understand request
    1) Wrong Content-Type declaration
    2) Application/type is not json
    Check for the "Content-Type" is application/json when request.
    400 When not use URL Encoded character in API Request URL Check whether API request URL has URL encoded character.
    401 1) When Access Token is missing
    2) When Access Token is wrong
    3) When Access Token is expired
    4) Unrecognizable client
    Check whether the Access Token is granted and used via valid process.
    401 client_id is missing when using Front API Check whether using valid client_id.
    403 1) Access Token does not include Scope authority
    2) Access forbidden for Front API
    Check the Scope of API or setting of shopping mall whether you have the authority for request API.
    403 Not a https protocol Check whether request protocol is https.
    403 Shopping mall has not been upgraded to a 'New product' mall Shopping mall has to be upgraded to a 'New product' mall in order to use API.
    403 (Admin API) App has been deleted from the shopping mall. Install again after check whether the App is installed at the shopping mall.
    403 (Front API) App has been deleted from the shopping mall. Install again after check whether the App is installed at the shopping mall.
    404 1) When requested wrong API URL
    2) When cannot found resource
    3) When missing {#id}
    Check the API reference for errors in URL.
    422 When requested value is unprocessible with API reference
    1) Missing necessary parameter
    2) Not same with API reference
    Check the API reference for whether omitted necessary parameter or put a wrong value.
    429 When client requested over than Bucket volume Request later in a while for not exceed maximum request.
    500 Internal server error or unknown error A temporary error has occurred. Please try again.
    503 Server is unavailable Please contact to developer center.
    503 Server is unavailable. Cannot use API right now Please contact to developer center.
    504 Timeout Response timeout due to a temporary error. Please try again later.

    How to use GET API

    Cafe24 API provides several ways to get the data.

    The following describes the different ways to recall data using various parameters when inquiring an API.

    1.Add search criteria

    When inquiring API, you can search search conditions by adding parameters to the endpoint.

    If you are searching for multiple criteria together, you can add search criteria using the "&" separator.

    You can also search using the "&" separator when searching for ranges such as start date, end date.

    Add search criteria

    Example: If you want to search for products with prices over \1,000 within a particular brand
    GET https://{mallid}.cafe24api.com/api/v2/products?brand_code=B000000A&price_min=1000
    
    
    GET https://{mallid}.cafe24api.com/api/v2/products?created_start_date=2018-01-03&created_end_date=2018-02-03
    

    2. Search several conditions in parameter.

    Multiple values can be retrieved simultaneously using commas(,) if supported by the API. (Only less than 100 items are allowed.)

    Search criteria that are added as commas(,) are the OR condition, and all values that match that search condition are scanned.

    To search multiple sections of a parameter

    Example: When inquiring information of products 11, 12 or 13
    GET https://{mallid}.cafe24api.com/api/v2/products?product_no=11,12,13
    

    3. Multiple shopping mall information check

    If you specify a particular shop_no during API lookup, you can inquire information in the corresponding multI-collar shopping mall.

    If you don't specify a particular shop_no, check the information in shopping mall 1(default shopping mall).

    Searching for Multi-shop information

    Example: Check the products of shopping mall number 2
    GET https://{mallid}.cafe24api.com/api/v2/products?shop_no=2
    

    4. Check details and key

    Most Resource can inquire in detail by specifying the ID of Resource in the URL.

    You can query only one Resource, but more items are returned than if you are viewing the list.

    Detailed inquiry and single item check

    Example: How to check product number 128 in detail
    GET https://{mallid}.cafe24api.com/api/v2/admin/products/128
    
    
    Example: If you want to check the product number 128 using parameters
    GET https://{mallid}.cafe24api.com/api/v2/admin/products?product_no=128
    

    5. Pagination

    If you have too many items to query when inquiring a list, all results may not be inquired at once.

    If you want to inquire more results at once, use the 'limits' parameter to expand the number of queries.

    If you do not use the 'limits' parameter, you can inquire only the default value of 'limits'.

    The number of queries that can be extended with the limit parameter can be extended only to the maximum value defined for each API.

    If the limit limit can not be used for all data, the 'offset' parameter can be used.

    The 'offset' parameter can be used to determine the item to be inquired after starting with the previous product.

    Pagination

    Example: Check 100 products at a time
    GET https://{mallid}.cafe24api.com/api/v2/admin/products?limit=100
    
    
    Example: Check product 201 to product 300
    GET https://{mallid}.cafe24api.com/api/v2/admin/products?limit=100&offset=200
    

    6. Field Parameters

    If you want to query only certain values in the API, you can inquire the values using the field parameters.

    Field Parameters

    Example: When inquiring a product, check only the product name and product number parameters.
    GET https://{mallid}.cafe24api.com/api/v2/admin/products?fields=product_name,product_no
    

    7. Embed Parameters

    Embedded Resource belonging to the product when inquiring an item (e.g. variants,inventories) If you need to inquire the item and inventory together, you can inquire the data of the lower resource with using the ' embed ' parameter.

    You can use the ' embed ' parameter only in the API that supports it.

    Embed parameters

    Example: When inquiring a product, check its option and item data together.
    GET https://{mallid}.cafe24api.com/api/v2/admin/products/570?embed=variants,inventories
    

    API Limit

    Cafe 24 API works with the "Leaky Bucket" algorithm. The Leaky Bucket algorithm has the effect of limiting the number of API requests that are abnormally high for performance purposes, but also allowing the use of routine API requests without restriction.

    Cafe 24 API stacks API requests in the dock. Bucket is limited to API calls when up to "Request Limit" per shopping mall are filled. The Bucket is decreased twice per second and can be recalled as a decrease.

    • If the app calls the API twice a second, you can continue to use the API calls without restriction.

    • If more than "Request Limit" calls are generated momentarily within a second, return the 429 error (too many requests).

    You can avoid the 429 error by checking the X-Api-Call-Limit with the header. You can see how many APIs have been ordered from the shopping mall, and how many Buckets are left.

    X-Api-Call-Limit : 1/30
    

    Versioning

    Version 2019-12-11 (latest)

    You can check the version release date for changes not compatible with the previous version.

    You can specify a version of your choice in custom headers "X-Cafe24-Api-Version". If not specified, the latest version is used.

    Example (request)

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: 'BrIfqEKoP.......',
      version: '2019-12-11'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: BrIfqEKoP.......' \
      -H 'X-Cafe24-Api-Version: 2019-12-11'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "BrIfqEKoP.......")
      .addHeader("X-Cafe24-Api-Version", "2019-12-11")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "BrIfqEKoP.......",
        'X-Cafe24-Api-Version': "2019-12-11"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "BrIfqEKoP.......",
        'X-Cafe24-Api-Version': "2019-12-11"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: BrIfqEKoP.......',
        'X-Cafe24-Api-Version: 2019-12-11'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "BrIfqEKoP.......")
        req.Header.Add("X-Cafe24-Api-Version", "2019-12-11")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Category

    Categories

    Categories Resource

    Categories is a categories that can be used to display or classify products so that shopping mall customers can find them easily. Items must be displayed in one or more product categories for sale. A single item can be displayed in multiple product categories.

    Categories properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    category_no

    Category number

    Unique number of each category. This number cannot be duplicated.

    category_depth

    Min : [1]~Max : [4]

    Category depth

    Shows which depth the category is. There are 4 level of category.

    parent_category_no

    Parent Category Number

    Shows number of upper level of category if the category is among medium scale classification, small scale classification, and micro scale classification.

    When parent_category_no = 1, the category indicates a large scale classification.

    category_name

    Max Length : [50]

    Category name

    Shows the name of the category

    full_category_name

    Full Category Name

    Shows the name of own level and upper level of category if the category is among medium scale classification, small scale classification, and micro scale classification.

    full_category_no

    Full Category Number

    Shows the number of own level and upper level of category if the category is among medium scale classification, small scale classification, and micro scale classification.

    root_category_no

    Top category number

    Shows number of highest level of category of which category belongs.

    display_order

    Display order

    The order of category which is placed by shopping mall operator.

    hash_tags

    Hashtag

    Hashtags of the category.

    ※ This feature is only available when use shopping curation service.

    List all categories

    GET

    Specification

    Property Description
    SCOPE mall.read_category
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    category_depth

    Min : [1]~Max : [4]

    Category depth

    Number of depth of category to search.

    category_no

    Category number

    Number of category for search.

    parent_category_no

    Parent Category Number

    Search for the number of parent category which targeting product category belongs.

    If you want to search only large scale classification, search parent_category_no = 1.

    category_name

    Category name

    Search for product category that contain search terms in a category name. (Do not distinguish between capital and lowercase letters)

    limit

    Max : [100]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    offset

    Max : [8000]

    Start location of list

    Set the start location of search result.

    Definition Copy

    GET https://{domain}/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    
    GET https://{mallid}.cafe24api.com/api/v2/categories
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "categories": [
            {
                "shop_no": 1,
                "category_no": 27,
                "category_depth": 1,
                "parent_category_no": 1,
                "category_name": "(large scale classification) Bottoms",
                "full_category_name": {
                    "1": "(Main Category) Tops",
                    "2": "(Middle Category) Tees",
                    "3": "(Small Category) Long Sleeve",
                    "4": "(Detailed Category) Cropped"
                },
                "root_category_no": 27,
                "display_order": 0,
                "full_category_no": {
                    "1": "25",
                    "2": "28",
                    "3": "30",
                    "4": "40"
                },
                "hash_tags": [
                    "tag1",
                    "tag2"
                ]
            },
            {
                "shop_no": 1,
                "category_no": 28,
                "category_depth": 1,
                "parent_category_no": 1,
                "category_name": "(large scale classification) Accessories",
                "full_category_no": {
                    "1": "28",
                    "2": null,
                    "3": null,
                    "4": null
                },
                "full_category_name": {
                    "1": "(large scale classification) Accessories",
                    "2": null,
                    "3": null,
                    "4": null
                },
                "display_order": 0,
                "hash_tags": [
                    "tag1",
                    "tag2"
                ]
            }
        ]
    }
    

    Count all categories

    GET

    Specification

    Property Description
    SCOPE mall.read_category
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    category_depth

    Min : [1]~Max : [4]

    Category depth

    Number of depth of category to search.

    category_no

    Category number

    Number of category for search.

    parent_category_no

    Parent Category Number

    Search for the number of parent category which targeting product category belongs.

    If you want to search only large scale classification, search parent_category_no = 1.

    category_name

    Category name

    Search for product category that contain search terms in a category name. (Do not distinguish between capital and lowercase letters)

    Definition Copy

    GET https://{domain}/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/count
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories/count', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories/count' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories/count")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories/count"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories/count',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories/count',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories/count"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "count": 3
    }
    

    Get a category

    GET

    Specification

    Property Description
    SCOPE mall.read_category
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    category_no
    Required

    Category number

    Number of category for search.

    Definition Copy

    GET https://{domain}/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories/40', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories/40' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories/40")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories/40"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories/40',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories/40',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories/40"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "category": {
            "shop_no": 1,
            "category_no": 40,
            "category_depth": 4,
            "parent_category_no": 37,
            "category_name": "(Detailed Category) Cropped",
            "full_category_no": {
                "1": "25",
                "2": "28",
                "3": "30",
                "4": "40"
            },
            "full_category_name": {
                "1": "(Main Category) Tops",
                "2": "(Middle Category) Tees",
                "3": "(Small Category) Long Sleeve",
                "4": "(Detailed Category) Cropped"
            },
            "display_order": 0,
            "hash_tags": [
                "tag1",
                "tag2"
            ]
        }
    }
    

    Product

    Categories products

    A relational resource that lets you retrieve or update product display order or general display settings.

    Categories products properties

    Attribute Description
    shop_no

    Shop Number

    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    product_name

    Product name

    manufacturer_name

    Manufacturer

    origin_place_value

    origin

    retail_price

    Product retail price

    price

    Price

    interest_free_period

    interest-free installment payment period

    eng_product_name

    English name of product

    custom_product_code

    Custom product code

    point_amount

    Points

    brand_name

    Brand name

    model_name

    Model name

    price_excluding_tax

    Product price

    tax

    Tax amount

    product_code

    Product code

    simple_description

    Simple Product Description

    summary_description

    Product Summary Description

    supplier_name

    Supplier name

    made_date

    timezone

    Date of manufacture

    review_count

    number of reviews

    expiration_date

    Expiration date

    coupon_discounted_price

    Coupon-discounted price

    trend_name

    Trend name

    shipping_scope

    Shipping information

    shipping_fee_type

    Shipping charge

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Charge shipping by section

    shipping_fee

    Shipping fee

    discount_price

    Discounted price

    shipping_method

    Shipping method

    promotion_period

    Discount & sales schedule

    color

    Product color

    translated_additional_description

    Translated additional description

    stock_quantity

    Inventory quantity

    question_count

    number of product inquiries

    product_article_count

    number or product boards

    List all categories products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    mobile

    whether a mobile setup value has been retrieved

    T: Use
    F: Do not use

    shop_no

    Shop Number

    DEFAULT 1

    category_no
    Required

    Category number

    display_group
    Required

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    limit

    Max : [200]

    Limit

    DEFAULT 100

    offset

    Max : [8000]

    Start location of list

    Definition Copy

    GET https://{domain}/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories/40/products?display_group=1', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories/40/products?display_group=1"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "products": [
            {
                "shop_no": 1,
                "product_no": 20,
                "product_name": "iPhone X",
                "manufacturer_name": "APPLE",
                "origin_place_value": "Korea",
                "retail_price": "0.00",
                "price": "11000.00",
                "interest_free_period": "",
                "eng_product_name": "iPhone Ten",
                "custom_product_code": "",
                "point_amount": [
                    {
                        "payment_method": "card",
                        "type": "P",
                        "value": "110.00",
                        "rate": "10.00"
                    },
                    {
                        "payment_method": "cash",
                        "type": "W",
                        "value": "100.00",
                        "rate": ""
                    }
                ],
                "brand_name": "",
                "model_name": "A1865",
                "price_excluding_tax": "10000.00",
                "tax": "1000.00",
                "product_code": "P000000X",
                "simple_description": "This is Product Description.",
                "summary_description": "This is Product Summary.",
                "supplier_name": "SUPPLIER NAME",
                "made_date": "",
                "review_count": 0,
                "expiration_date": {
                    "start_date": "2019-07-08",
                    "end_date": "2019-09-14"
                },
                "coupon_discounted_price": "",
                "trend_name": "",
                "shipping_scope": "Domestic/International shipping",
                "shipping_fee_type": "R",
                "shipping_rates": "",
                "shipping_fee": "2500.00",
                "discount_price": "",
                "shipping_method": "Courier Service",
                "promotion_period": {
                    "start_date": "2019-07-11T00:00:00+09:00",
                    "end_date": "2019-07-16T23:55:00+09:00",
                    "dc_price": "220.00"
                },
                "color": [
                    "#000000",
                    "#C20F0A"
                ],
                "translated_additional_description": "This is a translated additional description of product.",
                "stock_quantity": 10,
                "question_count": 0,
                "product_article_count": 0
            },
            {
                "shop_no": 1,
                "product_no": 21,
                "product_name": "iPhone X",
                "manufacturer_name": "APPLE",
                "origin_place_value": "Korea",
                "retail_price": "0.00",
                "price": "11000.00",
                "interest_free_period": "",
                "eng_product_name": "iPhone Ten",
                "custom_product_code": "",
                "point_amount": [
                    {
                        "payment_method": "mileage",
                        "type": "W",
                        "value": "100.00",
                        "rate": ""
                    }
                ],
                "brand_name": "",
                "model_name": "A1865",
                "price_excluding_tax": "10000.00",
                "tax": "1000.00",
                "product_code": "P000000X",
                "simple_description": "This is Product Description.",
                "summary_description": "This is Product Summary.",
                "supplier_name": "SUPPLIER NAME",
                "made_date": "",
                "review_count": 0,
                "expiration_date": {
                    "start_date": "2019-07-08",
                    "end_date": "2019-09-14"
                },
                "coupon_discounted_price": "",
                "trend_name": "",
                "shipping_scope": "Domestic/International shipping",
                "shipping_fee_type": "W",
                "shipping_rates": [
                    {
                        "shipping_rates_min": "1.00",
                        "shipping_rates_max": "2.00",
                        "shipping_fee": "2500.00"
                    },
                    {
                        "shipping_rates_min": "2.00",
                        "shipping_rates_max": "3.00",
                        "shipping_fee": "3000.00"
                    }
                ],
                "shipping_fee": "",
                "discount_price": "",
                "shipping_method": "Courier Service",
                "promotion_period": {
                    "start_date": "2019-07-11T00:00:00+09:00",
                    "end_date": "2019-07-16T23:55:00+09:00",
                    "dc_price": "220"
                },
                "color": [
                    "#000000",
                    "#C20F0A"
                ],
                "translated_additional_description": "This is a translated additional description of product.",
                "stock_quantity": 10,
                "question_count": 0,
                "product_article_count": 0
            }
        ]
    }
    

    Count all categories products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    category_no
    Required

    Category number

    display_group
    Required

    Min : [1]~Max : [3]

    detailed product category

    1 : Regular product
    2 : Recommend product
    3 : New product

    Definition Copy

    GET https://{domain}/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/categories/{category_no}/products/count
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/categories/40/products/count?display_group=1', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/categories/40/products/count?display_group=1"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "count": 2
    }
    

    Mains products

    A relational resource to the Mains resource about main category products’ display order.

    Mains products properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    product_no

    Product number

    product_name

    Product name

    manufacturer_name

    Manufacturer

    origin_place_value

    origin

    retail_price

    Product retail price

    price

    Price

    interest_free_period

    interest-free installment payment period

    eng_product_name

    English name of product

    custom_product_code

    Custom product code

    point_amount

    Points

    brand_name

    Brand name

    model_name

    Model name

    price_excluding_tax

    Product price

    tax

    Tax amount

    product_code

    Product code

    simple_description

    Simple Product Description

    summary_description

    Product Summary Description

    supplier_name

    Supplier name

    made_date

    timezone

    Date of manufacture

    review_count

    number of reviews

    expiration_date

    Expiration date

    coupon_discounted_price

    Coupon-discounted price

    trend_name

    Trend name

    shipping_scope

    Shipping information

    shipping_fee_type

    Shipping charge

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Charge shipping by section

    shipping_fee

    Shipping fee

    discount_price

    Discounted price

    shipping_method

    Shipping method

    promotion_period

    Discount & sales schedule

    color

    Product color

    translated_additional_description

    Translated additional description

    stock_quantity

    Inventory quantity

    question_count

    number of product inquiries

    product_article_count

    number or product boards

    List all mains products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    mobile

    whether a mobile setup value has been retrieved

    T: Use
    F: Do not use

    shop_no

    Shop Number

    DEFAULT 1

    display_group
    Required

    main category number

    limit

    Max : [200]

    Limit

    DEFAULT 100

    offset

    Max : [8000]

    Start location of list

    Definition Copy

    GET https://{domain}/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    
    GET https://{mallid}.cafe24api.com/api/v2/mains/{display_group}/products
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/mains/2/products', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/mains/2/products' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/mains/2/products")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/mains/2/products"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/mains/2/products',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/mains/2/products',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/mains/2/products"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "products": [
            {
                "shop_no": 1,
                "product_no": 20,
                "product_name": "iPhone X",
                "manufacturer_name": "APPLE",
                "origin_place_value": "Korea",
                "retail_price": "0.00",
                "price": "11000.00",
                "interest_free_period": "",
                "eng_product_name": "iPhone Ten",
                "custom_product_code": "",
                "point_amount": [
                    {
                        "payment_method": "card",
                        "type": "P",
                        "value": "110.00",
                        "rate": "10.00"
                    },
                    {
                        "payment_method": "cash",
                        "type": "W",
                        "value": "100.00",
                        "rate": ""
                    }
                ],
                "brand_name": "",
                "model_name": "A1865",
                "price_excluding_tax": "10000.00",
                "tax": "1000.00",
                "product_code": "P000000X",
                "simple_description": "This is Product Description.",
                "summary_description": "This is Product Summary.",
                "supplier_name": "SUPPLIER NAME",
                "made_date": "",
                "review_count": 0,
                "expiration_date": {
                    "start_date": "2019-07-08",
                    "end_date": "2019-09-14"
                },
                "coupon_discounted_price": "",
                "trend_name": "",
                "shipping_scope": "Domestic/International shipping",
                "shipping_fee_type": "R",
                "shipping_rates": "",
                "shipping_fee": "2500.00",
                "discount_price": "",
                "shipping_method": "Courier Service",
                "promotion_period": {
                    "start_date": "2019-07-11T00:00:00+09:00",
                    "end_date": "2019-07-16T23:55:00+09:00",
                    "dc_price": "220"
                },
                "color": [
                    "#000000",
                    "#C20F0A"
                ],
                "translated_additional_description": "This is a translated additional description of product.",
                "stock_quantity": 10,
                "question_count": 0,
                "product_article_count": 0
            },
            {
                "shop_no": 1,
                "product_no": 21,
                "product_name": "iPhone X",
                "manufacturer_name": "APPLE",
                "origin_place_value": "Korea",
                "retail_price": "0.00",
                "price": "11000.00",
                "interest_free_period": "",
                "eng_product_name": "iPhone Ten",
                "custom_product_code": "",
                "point_amount": [
                    {
                        "payment_method": "mileage",
                        "type": "W",
                        "value": "100.00",
                        "rate": ""
                    }
                ],
                "brand_name": "",
                "model_name": "A1865",
                "price_excluding_tax": "10000.00",
                "tax": "1000.00",
                "product_code": "P000000X",
                "simple_description": "This is Product Description.",
                "summary_description": "This is Product Summary.",
                "supplier_name": "SUPPLIER NAME",
                "made_date": "",
                "review_count": 0,
                "expiration_date": {
                    "start_date": "2019-07-08",
                    "end_date": "2019-09-14"
                },
                "coupon_discounted_price": "",
                "trend_name": "",
                "shipping_scope": "Domestic/International shipping",
                "shipping_fee_type": "W",
                "shipping_rates": [
                    {
                        "shipping_rates_min": "1.00",
                        "shipping_rates_max": "2.00",
                        "shipping_fee": "2500.00"
                    },
                    {
                        "shipping_rates_min": "2.00",
                        "shipping_rates_max": "3.00",
                        "shipping_fee": "3000.00"
                    }
                ],
                "shipping_fee": "",
                "discount_price": "",
                "shipping_method": "Courier Service",
                "promotion_period": {
                    "start_date": "2019-07-11T00:00:00+09:00",
                    "end_date": "2019-07-16T23:55:00+09:00",
                    "dc_price": "220.00"
                },
                "color": [
                    "#000000",
                    "#C20F0A"
                ],
                "translated_additional_description": "This is a translated additional description of product.",
                "stock_quantity": 10,
                "question_count": 0,
                "product_article_count": 0
            }
        ]
    }
    

    Products

    Products Resource 관계도
    Product' represents goods that sells at shopping mall. Product API can register, search, modify, and delete product. (delete function will be provide.)

    Products has the following Resource as embedded Resource:
    Variants
    Hits
    Memos
    SEO

    Products properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    product_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Product code

    System assigned code. This code cannot be duplicated.

    custom_product_code

    Max Length : [40]

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    product_name

    Max Length : [250]

    Product name

    Name of product. Basic information to search the product and seperate each product. You may input this with HTML.

    eng_product_name

    Max Length : [250]

    English name of product

    English name of product. Necessary when shipping to abroad.

    model_name

    Max Length : [100]

    Model name

    Model name of product

    price_excluding_tax

    product price (before VAT)

    price

    Product price

    Selling price. Price that before applying coupon or other benefits.

    At the time of product create, all multi-shopping mall's products have the same price. If you want to enter a different price for each multi-shopping mall, you can enter the price differently by modifying the product.

    ※ Price of product when automatically calculated = [ Value of supply + (Value of supply * Rate of margin) + addtional cost ]

    retail_price

    Product retail price

    General price of the product in market. This is used to compare the price of a shopping mall and to emphasize the price of a shopping mall.

    display

    Whether display

    User can choose product should be displayed or not. If product is not displayed, customer can't access product thus cannot buy the product.

    T: Display
    F: Do not display

    selling

    whether selling

    User can choose product status should be selling or not. If product is not selling, customer can still access product but cannot buy the product since the product will be displayed as "Sold out".

    If display is FALSE and selling is TRUE, customer can't access product thus cannot buy the product.

    T: Sell
    F: Do not sell

    product_used_month

    Max : [2147483647]

    Months of using the used product

    summary_description

    Max Length : [255]

    Product Summary Description

    Summary description of product. Can Exposed at product display screen. You may input description with HTML.

    product_tag

    Max Length : [200]

    Product tag

    Search tags.

    price_content

    Max Length : [20]

    Alternative phrase of the selling price

    Price will be replaced by this text when sold-out or unavailable for some reasons.

    buy_limit_by_product

    whether purchase restriction individual setting

    T: use
    F: do not use

    buy_limit_type

    Purchase limitation

    Limit purchase as below information.

    N: Members only and hide purchase button.
    M: Members only but does not hide purchase button.
    F: No limitation.

    repurchase_restriction

    repurchase restriction

    T : restrict repurchase
    F : do not restrict repurchase

    single_purchase_restriction

    single purchase restriction

    T : restrict single purchase
    F : do not restrict on single purchase

    buy_unit_type

    Type of Purchase unit

    If the purchase unit of the product is set to 1 or more, the setting of whether the purchase unit is the item unit or the product unit

    P: Based on product
    O: Based on quantity

    buy_unit

    Minimum unit per purchase

    Minimum unit per purchase.

    Ex ) If product's minimum unit per purchase is 3, customer can only buy the product as multiple number of 3.

    order_quantity_limit_type

    Criteria of order quantity restriction

    If you limit the order quantity of the product, you can set whether the limit should be based on item or product unit.

    P: Based on product
    O: Based on quantity

    minimum_quantity

    Max : [2147483647]

    Minimum quantity per purchase

    Minimum quantity per purchase. Customer cannot buy the product below the minimum quantity.

    maximum_quantity

    Max : [2147483647]

    Maximum quantity per purchase

    Maximum quantity per purchase. Customer cannot buy the product above the maximum quantity.

    If the maximum order quantity is "no limit", it is displayed as "0".

    points_by_product

    individual settings for points

    F : use default setting
    T : individual setting

    points_setting_by_payment

    points settings by payment method

    B : Use the default reserve setting
    C : Earn based on the payment method

    points_amount

    points settings information

    adult_certification

    Adult certification

    Whether the product requires adult certification. Customer needs to be authenticated to purchase products that require adult certification.

    detail_image

    Detail image

    Detail image' showing on the product detail page.

    list_image

    List image

    List image' showing on the product category page, main page, product search result page.

    tiny_image

    Tiny image

    Small list image' showing on the recently viewed page.

    small_image

    Reduced image

    Reduced image' showing on the bottom side of the product detail page.

    has_option

    Whether the option is used

    Shows product either has an option or not. Product with option offer various choices such as size, color, and flavors.

    T: use option
    F: do not use option

    option_type

    Type of option

    Shows type of option when "has_option" is TRUE.

    ● combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    ● combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.
    ● linked with product : The way how to show type of option is similar to 'combination types' but this type can choose both 'necessary option' and 'selectable option'. This type can make 'unlimited combinations of options'.
    ● independently selectable : Customer can select 'each indepentent options'. 'Each option' will be generated as 'each variant'.

    C: Combination integration option
    S: Combination separation option
    E: Product connection
    F: Independent selection

    use_naverpay

    whether use Naver Pay

    T: Used
    F: Not used

    naverpay_type

    Naver Pay sales type

    C : Naver Pay + Shopping Mall Products at the same time
    O : Naver Pay only products

    manufacturer_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Manufacturer code

    Code uses for designate specific manufacturer. This code generated automatically when register a new manufacturer.

    Set as default code(M0000000) if doesn't input.

    trend_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Trend code

    Code uses for designate specific trend. This code generated automatically when register a new trend.

    Set as default code(T0000000) if doesn't input.

    brand_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Brand code

    Code uses for designate specific brand. This code generated automatically when register a new brand.

    Set as default code(B0000000) if doesn't input.

    made_date

    Date of manufacture

    Date of manufacture of the product.

    expiration_date

    Array Max : [2]

    Expiration date

    Indicate the expiration date of intangible goods such as gift certificates or tickets or type goods such as food or cosmetics.

    origin_classification

    Origin classification

    Distinguish the origin of a product.

    F: domestic
    T: abroad
    E: other

    origin_place_no

    Origin place no

    List the origin number List all Origin by API
    If origin_classification is F (domestic), it is possible to enter origin only if foreign (foreign) is "F".
    If origin_classification is T (overseas), it is possible to enter origin only if foreign (foreign) is "T".

    origin_place_value

    Max Length : [30]

    Extra information for code of origin

    You may add additional information if 'origin_place_code' is 1800.

    made_in_code

    Origin country code

    icon_show_period

    Period for showing icon

    Period for showing icon.

    icon

    Array Max : [5]

    List of icon

    Icon displays at the product. This icon can use a purpose of emphsize selling.

    product_material

    Material of product

    The material of the item. You should enter each material and percentage of composing material if the product is has a multiple material.

    list_icon

    Recommend / sold out / new icon expose flag

    Either showing recommend / sold out / new icon will be exposed or not.

    ※ sold out icon

    ● Showing that the product is sold out
    ● Displays out of stock if mall using stock management function

    ※ recommend / new icon

    ● If the item is displayed in the area of category or the recommendation product on the main page or new product, shows the icon as it set.

    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Use
    F: Do not use

    approve_status

    Approve request result

    N: New request for approval
    E: request for approval updated
    C: Approval complete
    R: Approval rejected
    I: Approval in progress
    Empty Value: Never requested

    sold_out

    Whether sold out or stock is available

    T: Out-of-stock
    F: No out-of-stock

    discountprice

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages

    Decoration Image Resource


    Can search with using embed parameter.

    benefits

    Benefits Resource


    Can search with using embed parameter.

    options

    Product Option Resource


    Can search with using embed parameter.

    variants

    Variants Resource


    Can search with using embed parameter.

    clearance_category_code

    Type : [A-Z0-9]
    Length Min : [8]~Max : [8]

    Clearance category code

    clearance_category_code

    memos

    Memos Resource


    Can search with using embed parameter.

    It can be displayed only in detail inquiry.

    hits

    Product hits Resource


    Can search with using embed parameter.

    It can be displayed only in detail inquiry.

    seo

    Product Seo Resource


    Can search with using embed parameter.

    It can be displayed only in detail inquiry.

    category

    Category number

    Category of the product. Product is marked with this category.

    It can be displayed only in detail inquiry.

    project_no

    planned exhibition number

    It can be displayed only in detail inquiry.

    description

    Detail description of product

    Detail description of product. You may input description with HTML.

    It can be displayed only in detail inquiry.

    mobile_description

    Mobile version of product description

    Mobile version of product description. Replace product description to the mobile version when customer access a mobile shopping mall.

    It can be displayed only in detail inquiry.

    separated_mobile_description

    add mobile version

    It can be displayed only in detail inquiry.

    T: add mobile version product details
    F: apply PC version product details

    additional_image

    Array Max : [20]

    Additional image

    'Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    It can be displayed only in detail inquiry.

    payment_info

    Payment info

    Guidance for payment method. You may input this with HTML.

    It can be displayed only in detail inquiry.

    shipping_info

    Shipping info

    Guidance for shipping method. You may input this with HTML.

    It can be displayed only in detail inquiry.

    exchange_info

    Exchange info

    Guidance for exchange and return method. You may input this with HTML.

    It can be displayed only in detail inquiry.

    service_info

    Service info

    Guidance for service warranty information. You may input this with HTML.

    It can be displayed only in detail inquiry.

    product_tax_type_text

    Vat tax info

    Displays text set at VAT text setting menu.

    It can be displayed only in detail inquiry.

    set_product_type

    Product bundle type

    It can be displayed only in detail inquiry.

    C: integral type. S: assembled type

    simple_description

    Simple Product Description

    Simple description of product. Can Exposed at product display screen. You may input description with HTML.

    It can be displayed only in detail inquiry.

    tags

    Product Tag Resource


    Can search with using embed parameter.

    It can be displayed only in detail inquiry.

    shipping_method

    Shipping method

    Following is the method when 'individual_delivery' is TRUE

    It can be displayed only in detail inquiry.

    01: regular delivery
    02: fast service (document only)
    03: regular mail (document only)
    04: delivery in person
    05: delivery in person with bike or truck (within several hours)
    06: other
    07: cargo delivery
    08: pickup at a store
    09: delivery does not necessary

    prepaid_shipping_fee

    Whether prepaid shipping fee

    It can be displayed only in detail inquiry.

    C: Pay on delivery
    P: Prepaid
    B: Select Prepaid/Pay on delivery

    shipping_period

    Shipping period

    (When using 'Shipping charge individually') Average transit time for make a delivery.

    It can be displayed only in detail inquiry.

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    It can be displayed only in detail inquiry.

    A: Domestic only
    C: Export only
    B: Can deliver both inland and overseas

    shipping_area

    Max Length : [255]

    Shipping area

    (When using 'Shipping charge individually') Available shipping region.

    It can be displayed only in detail inquiry.

    shipping_fee_type

    Shipping charge

    (When using 'Shipping charge individually') Type of shipping charge.

    It can be displayed only in detail inquiry.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Charge shipping by section

    If shipping_fee_type is R or N, you can set the shipping cost by defining shipping_fee in the array.

    If shipping_fee_type is M, D, W, C, you can set the shipping interval by defining the following in the array.
    shipping_rates_min: Shipping interval start
    shipping_rates_max: Shipping interval end
    shipping_fee: shipping

    It can be displayed only in detail inquiry.

    origin_place_code

    Code of origin

    Code of origin

    It can be displayed only in detail inquiry.

    additional_information

    Additional information list

    You may add additional information other than basic information.

    It can be displayed only in detail inquiry.

    main

    whether display at main

    Displays main display number when display products at main page such as "recommend product" or "new".

    It can be displayed only in detail inquiry.

    relational_product

    Related product

    Related or similar product of selected product. Registered related product display the bottom of the product detail page.

    It can be displayed only in detail inquiry.

    List all products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    options
    embed

    Product Option Resource


    Can search with using embed parameter.

    variants
    embed

    Variants Resource


    Can search with using embed parameter.

    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no

    Product number

    Number of a product.

    You can search multiple item with ,(comma)

    display

    Whether display

    Search for products that displayed or not.

    selling

    whether selling

    Search for products that sell or not.

    product_name

    Product name

    Search for products that contain keyword in a product name (Case Insensitive)

    You can search multiple item with ,(comma)

    product_code

    Product code

    Search for products that include keyword in the product code. (Case Sensitive)

    You can search multiple item with ,(comma)

    brand_code

    Brand code

    Search for products with matching brand codes.

    You can search multiple item with ,(comma)

    manufacturer_code

    Manufacturer code

    Search for products with matching manufacturer code.

    You can search multiple item with ,(comma)

    supplier_code

    Supplier code

    Search for products with matching supplier code.

    You can search multiple item with ,(comma)

    trend_code

    Trend code

    Search for products with matching trend code.

    You can search multiple item with ,(comma)

    product_tag

    Product tag

    Search for products that include keyword in the product search term or tag. (Case Insensitive)

    You can search multiple item with ,(comma)

    custom_product_code

    Custom product code

    Search for products that include keyword in the custom product code. (Case Sensitive)

    You can search multiple item with ,(comma)

    custom_variant_code

    Custom variants code

    You can search multiple item with ,(comma)

    price_min

    Minimum price

    Search for products that price is over a certain range.

    price_max

    Maximum price

    Search for products that price is below a certain range.

    retail_price_min

    Min : [0]
    Max : [2147483647]

    Minimum retail price

    Search for products that retail price is over a certain range.

    retail_price_max

    Min : [0]
    Max : [2147483647]

    Maximim retail price

    Search for products that retail price is below a certain range.

    supply_price_min

    Minimum supply price

    Search for products that supply price is over a certain range.

    supply_price_max

    Maximum supply price

    Search for products that supply price is below a certain range.

    created_start_date

    timezone

    Registered date start

    Search for items that product creation date is after a certain date.
    Must use with 'created start date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    created_end_date

    timezone

    Registered date end

    Search for items that product creation date is before a certain date.
    Must use with 'created end date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    updated_start_date

    timezone

    Updated date start

    Search for items that product updated date is after a certain date.
    Must use with 'updated start date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    updated_end_date

    timezone

    Updated date end

    Search for items that product updated date is before a certain date.
    Must use with 'updated end date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    category

    Category number

    Search for items that displayed at a certain category.

    eng_product_name

    English name of product

    Search for products that contain keyword in a english product name (Case Insensitive)

    You can search multiple item with ,(comma)

    supply_product_name

    Supplier product name

    Search for products that include keyword in the supply product name. (Case Insensitive)

    You can search multiple item with ,(comma)

    internal_product_name

    internal product name

    You can search multiple item with ,(comma)

    model_name

    Model name

    Search for products that include keyword in the model name. (Case Insensitive)

    You can search multiple item with ,(comma)

    product_condition

    Product condition

    Search for products of specific condition.

    You can search multiple item with ,(comma)

    origin_place_value

    Origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    You can search multiple item with ,(comma)

    stock_quantity_max

    Maximum stock search

    Search for items that product stock is below a certain value.

    stock_quantity_min

    Minimum stock search

    Search for variants that product stock is above a certain value.

    If a product has several items, it searches if any of the items meet the condition.

    stock_safety_max

    Search of maximum safety inventory quantity

    stock_safety_min

    Search of minimum safety inventory quantity

    product_weight

    Weight of product

    Search for items that weigh certain kilograms.

    You can search multiple item with ,(comma)

    classification_code

    Classification code

    You can search multiple item with ,(comma)

    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants of the products.

    T: Use
    F: Do not use

    category_unapplied

    Unapplied Category

    Search for products that category unapplied.

    T : Search for products that category unapplied

    include_sub_category

    include sub category

    Search for products that include sub category.

    T: Included

    additional_information_key

    additional information key

    Search for products that has specific additional information. In order to search, key and value is necessary.

    additional_information_value

    additional information value

    Search for products that has specific additional information. In order to search, key and value is necessary.

    approve_status

    Approval Status

    N: Approval request (New product) status
    E: Approval request (Product modification) status
    C: Approved status
    R: Rejected status
    I: Checking status

    since_product_no

    Min : [1]
    Max : [2147483647]

    Search after a certain product number

    Search products from after a certain product number. Can search regardless of offset.

    ※ Cannot use below parameter when using this search condition.

    product_no
    sort
    order
    offset

    sort

    Sort order

    created_date: Created Date
    updated_date: Updated Date
    product_name: Product Name

    order

    Order by

    asc: Ascending
    desc: Descending

    offset

    Max : [5000]

    Start location of list

    Set the start location of search result.

    limit

    Max : [100]

    Limit

    Set the maximum number of search result.
    Example) input '10' shows only '10' result

    DEFAULT 10

    Definition Copy

    GET https://{domain}/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    
    GET https://{mallid}.cafe24api.com/api/v2/products
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "products": [
            {
                "shop_no": 1,
                "product_no": 24,
                "product_code": "P000000X",
                "custom_product_code": "",
                "product_name": "iPhone X",
                "eng_product_name": "iPhone Ten",
                "model_name": "A1865",
                "price_excluding_tax": "1000.00",
                "price": "1100.00",
                "retail_price": "0.00",
                "display": "T",
                "selling": "F",
                "product_used_month": 2,
                "summary_description": "This is Product Summary.",
                "price_content": null,
                "buy_limit_by_product": "T",
                "buy_limit_type": "F",
                "repurchase_restriction": "F",
                "single_purchase_restriction": "F",
                "buy_unit_type": "O",
                "buy_unit": 1,
                "order_quantity_limit_type": "O",
                "minimum_quantity": 1,
                "maximum_quantity": 0,
                "points_by_product": "T",
                "points_setting_by_payment": "C",
                "points_amount": [
                    {
                        "payment_method": "cash",
                        "points_rate": "0.00%"
                    },
                    {
                        "payment_method": "mileage",
                        "points_rate": "0.00%"
                    }
                ],
                "adult_certification": "F",
                "detail_image": "http://{domain}/web/product/big/201711/20_shop1_750339.png",
                "list_image": "http://{domain}/web/product/medium/201711/20_shop1_750339.png",
                "tiny_image": "http://{domain}/web/product/tiny/201711/20_shop1_750339.png",
                "small_image": "http://{domain}/web/product/small/201711/20_shop1_750339.png",
                "use_naverpay": "T",
                "naverpay_type": "C",
                "manufacturer_code": "M0000000",
                "trend_code": "T0000000",
                "brand_code": "B0000000",
                "made_date": "",
                "expiration_date": {
                    "start_date": "2017-09-08",
                    "end_date": "2017-09-14"
                },
                "origin_classification": "F",
                "origin_place_no": 1798,
                "origin_place_value": "",
                "made_in_code": "KR",
                "icon_show_period": {
                    "start_date": "2017-10-30T09:00:00+09:00",
                    "end_date": "2017-11-02T16:00:00+09:00"
                },
                "icon": [
                    "icon_01_01",
                    "icon_02_01"
                ],
                "product_material": "",
                "list_icon": {
                    "soldout_icon": true,
                    "recommend_icon": false,
                    "new_icon": false
                },
                "approve_status": "",
                "sold_out": "F",
                "clearance_category_code": "ACAB0000"
            },
            {
                "shop_no": 1,
                "product_no": 23,
                "product_code": "P000000W",
                "custom_product_code": "",
                "product_name": "iPhone X",
                "eng_product_name": "iPhone Ten",
                "model_name": "A1865",
                "price": 1000,
                "retail_price": 0,
                "display": "T",
                "selling": "F",
                "product_used_month": 2,
                "summary_description": "This is Product Summary.",
                "price_content": null,
                "buy_limit_by_product": "T",
                "buy_limit_type": "F",
                "repurchase_restriction": "F",
                "single_purchase_restriction": "F",
                "buy_unit_type": "O",
                "buy_unit": 1,
                "order_quantity_limit_type": "O",
                "minimum_quantity": 1,
                "maximum_quantity": 0,
                "points_by_product": "T",
                "points_setting_by_payment": "C",
                "points_amount": [
                    {
                        "payment_method": "cash",
                        "points_rate": "0.00%"
                    },
                    {
                        "payment_method": "mileage",
                        "points_rate": "0.00%"
                    }
                ],
                "adult_certification": "F",
                "detail_image": "http://{domain}/web/product/big/201711/20_shop1_750339.png",
                "list_image": "http://{domain}/web/product/medium/201711/20_shop1_750339.png",
                "tiny_image": "http://{domain}/web/product/tiny/201711/20_shop1_750339.png",
                "small_image": "http://{domain}/web/product/small/201711/20_shop1_750339.png",
                "use_naverpay": "T",
                "naverpay_type": "C",
                "manufacturer_code": "M0000000",
                "trend_code": "T0000000",
                "brand_code": "B0000000",
                "made_date": "",
                "expiration_date": {
                    "start_date": "2017-09-08",
                    "end_date": "2017-09-14"
                },
                "origin_classification": "F",
                "origin_place_no": 1798,
                "origin_place_value": "",
                "made_in_code": "KR",
                "icon_show_period": {
                    "start_date": "2017-10-30T09:00:00+09:00",
                    "end_date": "2017-11-02T16:00:00+09:00"
                },
                "icon": [
                    "icon_01_01",
                    "icon_02_01"
                ],
                "product_material": "",
                "list_icon": {
                    "soldout_icon": true,
                    "recommend_icon": false,
                    "new_icon": false
                },
                "approve_status": "C",
                "sold_out": "F",
                "clearance_category_code": null
            }
        ]
    }
    

    Count all products

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no

    Product number

    Number of a product.

    You can search multiple item with ,(comma)

    display

    Whether display

    Search for products that displayed or not.

    selling

    whether selling

    Search for products that sell or not.

    product_name

    Product name

    Search for products that contain keyword in a product name (Case Insensitive)

    You can search multiple item with ,(comma)

    product_code

    Product code

    System assigned code. This code cannot be duplicated.

    You can search multiple item with ,(comma)

    brand_code

    Brand code

    Search for products with matching brand codes.

    You can search multiple item with ,(comma)

    manufacturer_code

    Manufacturer code

    Search for products with matching manufacturer code.

    You can search multiple item with ,(comma)

    supplier_code

    Supplier code

    Search for products with matching supplier code.

    You can search multiple item with ,(comma)

    trend_code

    Trend code

    Search for products with matching trend code.

    You can search multiple item with ,(comma)

    product_tag

    Product tag

    Search for products that include keyword in the product search term or tag. (Case Insensitive)

    You can search multiple item with ,(comma)

    custom_product_code

    Custom product code

    Search for products that include keyword in the custom product code. (Case Sensitive)

    You can search multiple item with ,(comma)

    custom_variant_code

    Custom variants code

    You can search multiple item with ,(comma)

    price_min

    Minimum price

    Search for products that price is over a certain range.

    price_max

    Maximum price

    Search for products that price is below a certain range.

    retail_price_min

    Min : [0]
    Max : [2147483647]

    Minimum retail price

    Search for products that retail price is over a certain range.

    retail_price_max

    Min : [0]
    Max : [2147483647]

    Maximim retail price

    Search for products that retail price is below a certain range.

    supply_price_min

    Minimum supply price

    Search for products that supply price is over a certain range.

    supply_price_max

    Maximum supply price

    Search for products that supply price is below a certain range.

    created_start_date

    timezone

    Registered date start

    Search for items that product creation date is after a certain date.
    Must use with 'created start date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    created_end_date

    timezone

    Registered date end

    Search for items that product creation date is before a certain date.
    Must use with 'created end date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    updated_start_date

    timezone

    Updated date start

    Search for items that product updated date is after a certain date.
    Must use with 'updated start date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    updated_end_date

    timezone

    Updated date end

    Search for items that product updated date is before a certain date.
    Must use with 'updated end date' simultaneously.
    Search only on specific date if search start and end dates are the same.

    category

    Category number

    Search for items that displayed at a certain category.

    eng_product_name

    English name of product

    Search for products that contain keyword in a english product name (Case Insensitive)

    You can search multiple item with ,(comma)

    supply_product_name

    Supplier product name

    Search for products that include keyword in the supply product name. (Case Insensitive)

    You can search multiple item with ,(comma)

    internal_product_name

    internal product name

    You can search multiple item with ,(comma)

    model_name

    Model name

    Search for products that include keyword in the model name. (Case Insensitive)

    You can search multiple item with ,(comma)

    product_condition

    Product condition

    Search for products of specific condition.

    You can search multiple item with ,(comma)

    origin_place_value

    Origin

    Extra information for code of origin. You may add additional information if 'origin_place_code' is 1800.

    You can search multiple item with ,(comma)

    stock_quantity_max

    Maximum stock search

    Search for items that product stock is below a certain value.

    stock_quantity_min

    Minimum stock search

    Search for variants that product stock is above a certain value.

    If a product has several items, it searches if any of the items meet the condition.

    stock_safety_max

    Search of maximum safety inventory quantity

    stock_safety_min

    Search of minimum safety inventory quantity

    product_weight

    Weight of product

    Search for items that weigh certain kilograms.

    You can search multiple item with ,(comma)

    classification_code

    Classification code

    Search for products with matching custom classification code.

    You can search multiple item with ,(comma)

    use_inventory

    whether use inventory

    Whether use inventory management or not at the variants of the products.

    T: Use
    F: Do not use

    category_unapplied

    Unapplied Category

    Search for products that category unapplied.

    T : Search for products that category unapplied

    include_sub_category

    include sub category

    Search for products that include sub category.

    T: Included

    additional_information_key

    additional information key

    Search for products that has specific additional information. In order to search, key and value is necessary.

    additional_information_value

    additional information value

    Search for products that has specific additional information. In order to search, key and value is necessary.

    approve_status

    Approval Status

    N: Approval request (New product) status
    E: Approval request (Product modification) status
    C: Approved status
    R: Rejected status
    I: Checking status

    since_product_no

    Min : [1]
    Max : [2147483647]

    Search after a certain product number

    Search products from after a certain product number. Can search regardless of offset.

    ※ Cannot use below parameter when using this search condition.

    product_no
    sort
    order
    offset

    Definition Copy

    GET https://{domain}/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/count
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/count', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/count' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/count")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/count"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/count',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/count',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/count"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "count": 2
    }
    

    Get a product

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    Number of a product.

    variants
    embed

    Variants Resource


    Can search with using embed parameter.

    memos
    embed

    Memos Resource


    Can search with using embed parameter.

    hits
    embed

    Product hits Resource


    Can search with using embed parameter.

    seo
    embed

    Product Seo Resource


    Can search with using embed parameter.

    tags
    embed

    Product Tag Resource


    Can search with using embed parameter.

    options
    embed

    Product Option Resource


    Can search with using embed parameter.

    discountprice
    embed

    Product discount sale price Resource


    Can search with using embed parameter.

    decorationimages
    embed

    Decoration Image Resource


    Can search with using embed parameter.

    benefits
    embed

    Benefits Resource


    Can search with using embed parameter.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "product": {
            "shop_no": 1,
            "product_no": 20,
            "category": [
                {
                    "category_no": 27,
                    "recommend": "F",
                    "new": "T"
                },
                {
                    "category_no": 28,
                    "recommend": "T",
                    "new": "F"
                }
            ],
            "project_no": [
                31,
                32
            ],
            "product_code": "P000000T",
            "custom_product_code": "",
            "product_name": "iPhone X",
            "eng_product_name": "iPhone Ten",
            "model_name": "A1865",
            "price_excluding_tax": "1000.00",
            "price": "1100.00",
            "retail_price": "0.00",
            "display": "T",
            "description": "Sample Description.",
            "mobile_description": "Sample Mobile Description.",
            "separated_mobile_description": "T",
            "additional_image": [
                {
                    "big": "http://{domain}/web/product/extra/big/201810/a2803c44ee8299486ff19be239cef7d0.jpg",
                    "medium": "http://{domain}/web/product/extra/medium/201810/a2803c44ee8299486ff19be239cef7d0.jpg",
                    "small": "http://{domain}/web/product/extra/small/201810/a2803c44ee8299486ff19be239cef7d0.jpg"
                },
                {
                    "big": "http://{domain}/web/product/extra/big/201810/e1ab68969d69287a828438c7684b14c4.jpg",
                    "medium": "http://{domain}/web/product/extra/medium/201810/e1ab68969d69287a828438c7684b14c4.jpg",
                    "small": "http://{domain}/web/product/extra/small/201810/e1ab68969d69287a828438c7684b14c4.jpg"
                }
            ],
            "payment_info": "Sample payment info. You have to Pay.",
            "shipping_info": "Sample shipping info. You have to ship.",
            "exchange_info": "Sample exchange info. You have to exchange.",
            "service_info": "Sample service info. You have to service.",
            "product_tax_type_text": null,
            "set_product_type": null,
            "selling": "F",
            "product_used_month": 2,
            "simple_description": "This is Product Description.",
            "summary_description": "This is Product Summary.",
            "product_tag": "edu,test,sample",
            "price_content": null,
            "buy_limit_by_product": "T",
            "buy_limit_type": "F",
            "repurchase_restriction": "F",
            "single_purchase_restriction": "F",
            "buy_unit_type": "O",
            "buy_unit": 1,
            "order_quantity_limit_type": "O",
            "minimum_quantity": 1,
            "maximum_quantity": 0,
            "points_by_product": "T",
            "points_setting_by_payment": "C",
            "points_amount": [
                {
                    "payment_method": "cash",
                    "points_rate": "0.00%"
                },
                {
                    "payment_method": "mileage",
                    "points_rate": "0.00%"
                }
            ],
            "adult_certification": "F",
            "detail_image": "http://{domain}/web/product/big/201711/20_shop1_750339.png",
            "list_image": "http://{domain}/web/product/medium/201711/20_shop1_750339.png",
            "tiny_image": "http://{domain}/web/product/tiny/201711/20_shop1_750339.png",
            "small_image": "http://{domain}/web/product/small/201711/20_shop1_750339.png",
            "has_option": "F",
            "option_type": "T",
            "use_naverpay": "T",
            "naverpay_type": "C",
            "manufacturer_code": "M0000000",
            "trend_code": "T0000000",
            "brand_code": "B0000000",
            "made_date": "",
            "expiration_date": {
                "start_date": "2017-09-08",
                "end_date": "2017-09-14"
            },
            "origin_classification": "F",
            "origin_place_no": 1798,
            "origin_place_value": "",
            "made_in_code": "KR",
            "icon_show_period": {
                "start_date": "2017-10-30T09:00:00+09:00",
                "end_date": "2017-11-02T16:00:00+09:00"
            },
            "icon": null,
            "product_material": "",
            "shipping_method": "01",
            "prepaid_shipping_fee": "B",
            "shipping_period": {
                "minimum": 3,
                "maximum": 7
            },
            "shipping_scope": "A",
            "shipping_area": "All around World",
            "shipping_fee_type": "W",
            "shipping_rates": [
                {
                    "shipping_rates_min": "0.00",
                    "shipping_rates_max": "1.00",
                    "shipping_fee": "100.00"
                },
                {
                    "shipping_rates_min": "1.00",
                    "shipping_rates_max": "2.00",
                    "shipping_fee": "200.00"
                }
            ],
            "clearance_category_code": "ACAB0000",
            "origin_place_code": 1798,
            "list_icon": {
                "soldout_icon": true,
                "recommend_icon": true,
                "new_icon": true
            },
            "additional_information": [
                {
                    "key": "custom_option1",
                    "name": "gift option",
                    "value": "Yes"
                }
            ],
            "main": [
                3,
                2
            ],
            "relational_product": [
                {
                    "product_no": 17,
                    "interrelated": "T"
                },
                {
                    "product_no": 19,
                    "interrelated": "F"
                }
            ],
            "select_one_by_option": "F",
            "approve_status": "C",
            "sold_out": "F"
        }
    }
    

    Products decorationimages

    This resource lets you add special images to products displayed on a store. This resource lets you retrieve decorative images from a store and add them to a certain product, or retrieve the images already added to a product.

    This resource can only be used as a child resource of the Products resource.

    Products decorationimages properties

    Attribute Description
    shop_no

    Shop Number

    use_show_date

    whether use show date

    T: Use
    F: Do not use

    show_start_date

    timezone

    start date of show_date

    show_end_date

    timezone

    end date of show_date

    image_list

    list of decoration image

    List all products decoration images

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/decorationimages
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20/decorationimages', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20/decorationimages"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "decorationimage": {
            "use_show_date": "T",
            "show_start_date": "2017-10-30T09:00:00+09:00",
            "show_end_date": "2017-11-02T16:00:00+09:00",
            "image_list": [
                {
                    "code": "image_custom_4",
                    "path": "http://{domain}/web/upload/image_custom_415421761806290.gif",
                    "image_vertical_position": "T",
                    "image_horizontal_position": "L"
                },
                {
                    "code": "image_custom_3",
                    "path": "http://{domain}/web/upload/image_custom_615421761805558.gif",
                    "image_vertical_position": "B",
                    "image_horizontal_position": "C"
                }
            ]
        }
    }
    

    Products discountprice

    A resource about product's discount price. You can retrieve the discount price of products under the Benefits resource.

    This resource can only be used as a child resource of the Products resource. You can use the embed parameter in sending a request to retrieve product's discount price in one call.

    Products discountprice properties

    Attribute Description
    pc_discount_price

    PC discount price

    mobile_discount_price

    Mobile discount price

    List all products discountprice

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/discountprice
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/24/discountprice', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/24/discountprice' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/24/discountprice")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/24/discountprice"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/24/discountprice',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/24/discountprice',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/24/discountprice"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "discountprice": {
            "pc_discount_price": "7000.00",
            "mobile_discount_price": "6000.00"
        }
    }
    

    Products hits

    Product Views (Hits) is a measure of how much your products are viewed by your shopping mall customers. You can see how many products your customers are viewing most by checking product views.
    Product views can only be used in the Products subset as a embedded Resource.

    Count all products hits

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/hits/count
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/7/hits/count', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/7/hits/count' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/7/hits/count")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/7/hits/count"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/7/hits/count',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/7/hits/count',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/7/hits/count"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "count": 3
    }
    

    Products icons

    A product icon is a small image that you can add next to an item to emphasize it. You can emphasize items by adding messages such as discount information, "close to sold out" on the displayed products.
    The item icon can only be used in the Products subset as a embedded Resource.

    Products icons properties

    Attribute Description
    shop_no

    Shop Number

    use_show_date

    whether use show date

    T: Use
    F: Do not use

    show_start_date

    timezone

    start date of show_date

    show_end_date

    timezone

    end date of show_date

    image_list

    list of product icon

    List all products icons

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/icons
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20/icons', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20/icons' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20/icons")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20/icons"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20/icons',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20/icons',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20/icons"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "icons": {
            "shop_no": 1,
            "use_show_date": "T",
            "show_start_date": "2017-10-30T09:00:00+09:00",
            "show_end_date": "2017-11-02T16:00:00+09:00",
            "image_list": [
                {
                    "code": "custom_1",
                    "path": "http://{domain}/web/upload/custom_1.gif"
                },
                {
                    "code": "custom_2",
                    "path": "http://{domain}/web/upload/custom_2.gif"
                }
            ]
        }
    }
    

    Products options

    This resource allows customers to select a variant for a product that comes in different colors or sizes. This resource has the option_name property, which can for example be color or size, and the option_value property, which can for example be red or yellow. Product variants are generated based on their options when they are added to a product.

    This resource can only be used as a child resource of the Products resource.

    Products options properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    has_option

    Whether the option is used

    T: Use
    F: Do not use

    option_type

    Type of option

    Shows type of option when "has_option" is TRUE.

    ● combination : make 'a combination of option' based on 'the name of option'.
    ● linked with product : The way how to show type of option is similar to 'combination types' but this type can choose both 'necessary option' and 'selectable option'. This type can make 'unlimited combinations of options'.
    ● independently selectable : Customer can select 'each indepentent options'. 'Each option' will be generated as 'each variant'.

    T: Combination
    E: linked with product
    F: independently selectable

    option_list_type

    Option list type

    If you use the combined option, show the type of the combined option

    * combination all-selected : Shows combination of 'all options' in 'a single selecbox'(button or radio button).
    * combination separate-selected : Customer can choose 'options' at 'each selectbox'(button or radio button) and make 'a combination of option' based on 'the name of option'.

    If you use "linked with product" option or "independently selectable" option, S(separate selected) is used by default.

    C: Integrated type
    S: Separated type

    options

    Option

    select_one_by_option

    Whether select only one by option

    When using 'independently selectable' option type and this set as TRUE, customer can select only 1 item per option.
    If this set as FALSE, customer can select multiple items per option.

    ※ This Flag Is Only Available When Using 'Independently Selectable' Option Type.

    T: Use
    F: Do not use

    use_additional_option

    Whether use additional option

    T: Use
    F: Do not use

    additional_options

    Additional option

    use_attached_file_option

    Whether use attached file option

    T: Use
    F: Do not use

    attached_file_option

    Attached file option

    List all products options

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    DEFAULT 1

    product_no
    Required

    Product number

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/options
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/7/options', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/7/options' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/7/options")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/7/options"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/7/options',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/7/options',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/7/options"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "options": {
            "shop_no": 1,
            "product_no": 7,
            "has_option": "T",
            "option_type": "E",
            "option_list_type": "S",
            "options": [
                {
                    "option_code": "O000000A",
                    "option_name": "Color",
                    "option_value": [
                        {
                            "option_image_file": "http://{domain}/web/product/option_button/201804/temp_shop1_831549.gif",
                            "option_link_image": "http://{domain}/web/product/big/201604/1_shop1_423399.png",
                            "option_color": "#000000",
                            "option_text": "Black",
                            "value_no": null,
                            "additional_amount": "1000.00"
                        },
                        {
                            "option_image_file": "http://{domain}/web/product/option_button/201804/temp_shop1_831549.gif",
                            "option_link_image": "http://{domain}/web/product/big/201604/1_shop1_436875.png",
                            "option_color": "#007543",
                            "option_text": "Red",
                            "value_no": null,
                            "additional_amount": "1000.00"
                        }
                    ],
                    "required_option": "T",
                    "option_display_type": "S"
                },
                {
                    "option_code": "O000000B",
                    "option_name": "Size",
                    "option_value": [
                        {
                            "option_image_file": "http://{domain}/web/product/option_button/201804/temp_shop1_931549.gif",
                            "option_link_image": "",
                            "option_color": "#000000",
                            "option_text": "Small",
                            "value_no": null,
                            "additional_amount": "0.00"
                        },
                        {
                            "option_image_file": "http://{domain}/web/product/option_button/201804/temp_shop1_931549.gif",
                            "option_link_image": "",
                            "option_color": "#007543",
                            "option_text": "Large",
                            "value_no": null,
                            "additional_amount": "0.00"
                        }
                    ],
                    "required_option": "T",
                    "option_display_type": "S"
                }
            ],
            "select_one_by_option": "F",
            "use_additional_option": "T",
            "additional_options": [
                {
                    "additional_option_name": "Pattern",
                    "required_additional_option": "T",
                    "additional_option_text_length": 20
                },
                {
                    "additional_option_name": "Custom Option",
                    "required_additional_option": "F",
                    "additional_option_text_length": 10
                }
            ],
            "use_attached_file_option": "T",
            "attached_file_option": {
                "option_name": "Pattern Images",
                "required": "T",
                "size_limit": 3
            }
        }
    }
    

    Products variants

    Products Variants is the basic unit of goods sold in the shopping mall. Shopping malls usually sell the same items but different sizes or different colors to provide customers with different options.
    Products Variants has the following Resource as a embedded Resource:

    Inventories

    Products variants properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    variant_code

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    System assigned code. This code cannot be duplicated.

    options

    Option

    display

    Whether display

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Display
    F: Do not display

    selling

    whether selling

    Whether display the variants or not. If this set as TRUE, customer may choose the variants at product detail page or product list page. If this set as FALSE, variants will not be displayed thus cannot buy the variants.

    T: Sell
    F: Do not sell

    additional_amount

    Additional price

    Additional price for purchase the variants.

    quantity

    Available inventory

    safety_inventory

    minimum stock level

    inventories

    Inventories Resource

    Inventory Resource of variants.
    Can search with using embed parameter.

    List all products variants

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    inventories
    embed

    Inventories Resource

    Inventory Resource of variants.
    Can search with using embed parameter.

    You can search multiple item with ,(comma)

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20/variants', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20/variants' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20/variants")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20/variants"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20/variants',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20/variants',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20/variants"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "variants": [
            {
                "shop_no": 1,
                "variant_code": "P000000R000C",
                "options": [
                    {
                        "name": "Color",
                        "value": "Blue"
                    },
                    {
                        "name": "Size",
                        "value": "Small"
                    }
                ],
                "display": "T",
                "selling": "T",
                "additional_amount": "0.00",
                "quantity": 6,
                "safety_inventory": 7
            },
            {
                "shop_no": 1,
                "variant_code": "P000000R000D",
                "options": [
                    {
                        "name": "Color",
                        "value": "Red"
                    },
                    {
                        "name": "Size",
                        "value": "Small"
                    }
                ],
                "display": "T",
                "selling": "T",
                "additional_amount": "0.00",
                "quantity": 15,
                "safety_inventory": 0
            }
        ]
    }
    

    Get a products variant

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    inventories
    embed

    Inventories Resource


    Can search with using embed parameter.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20/variants/P000000R000C', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "variant": {
            "shop_no": 1,
            "variant_code": "P000000R000C",
            "options": [
                {
                    "name": "Color",
                    "value": "Black"
                },
                {
                    "name": "Size",
                    "value": "L"
                }
            ],
            "display": "T",
            "selling": "T",
            "additional_amount": "0.00",
            "quantity": 3,
            "safety_inventory": 8
        }
    }
    

    Products variants inventories

    Products Variants Inventories refers to the quantity of eligible items available for sale. Products Variants Inventories is available for each variant. If the variants sold out over than Products Variants Inventories, the product becomes out of stock status.

    Products variants inventories properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    variant_code

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    System assigned code. This code cannot be duplicated.

    quantity

    Available inventory

    Available inventory to sale. The number will deduct when order or payment made. Available inventory counted to shows 'Sold out' or not.

    safety_inventory

    minimum stock level

    Get products variants inventory

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    variant_code
    Required

    Type : [A-Z0-9]
    Length Min : [12]~Max : [12]

    Variant code

    Variants code for search sales volume.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/variants/{variant_code}/inventories
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/20/variants/P000000R000C/inventories', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/20/variants/P000000R000C/inventories"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "inventory": {
            "shop_no": 1,
            "variant_code": "P000000R000C",
            "quantity": 0,
            "safety_inventory": 0
        }
    }
    

    Productsdetail

    Productsdetail properties

    Attribute Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    It can be displayed only in detail inquiry.

    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    It can be displayed only in detail inquiry.

    detail_image

    Detail image

    Detail image' showing on the product detail page.

    It can be displayed only in detail inquiry.

    small_image

    Reduced image

    Reduced image' showing on the bottom side of the product detail page.

    It can be displayed only in detail inquiry.

    additional_images

    Array Max : [20]

    Additional image

    Additional image' showing on the bottom side of the product detail page. Displayed at similar location with 'Reduced image' and can see 'Additional image' when mouse over at PC version or swipe at mobile version.

    It can be displayed only in detail inquiry.

    product_name

    Product name

    Name of product. Basic information to search the product and seperate each product. You may input this with HTML.

    It can be displayed only in detail inquiry.

    manufacturer_name

    Manufacturer

    Name of manufacturer. Manufacturer name is the basic information for mall to distinguish each manufacturer.

    It can be displayed only in detail inquiry.

    origin_place_value

    origin

    It can be displayed only in detail inquiry.

    retail_price

    Product retail price

    General price of the product in market. This is used to compare the price of a shopping mall and to emphasize the price of a shopping mall.

    It can be displayed only in detail inquiry.

    price

    Price

    Selling price. Price that before applying coupon or other benefits.

    At the time of product create, all multi-shopping mall's products have the same price. If you want to enter a different price for each multi-shopping mall, you can enter the price differently by modifying the product.

    ※ Price of product when automatically calculated = [ Value of supply + (Value of supply * Rate of margin) + addtional cost ]

    It can be displayed only in detail inquiry.

    interest_free_period

    interest-free installment payment period

    It can be displayed only in detail inquiry.

    eng_product_name

    English name of product

    English name of product. Necessary when shipping to abroad.

    It can be displayed only in detail inquiry.

    custom_product_code

    Custom product code

    You may assign this code manually in case of stock management or other reasons.

    It can be displayed only in detail inquiry.

    points_amount

    Points

    It can be displayed only in detail inquiry.

    brand_name

    Brand name

    It can be displayed only in detail inquiry.

    model_name

    Model name

    Model name of product

    It can be displayed only in detail inquiry.

    price_excluding_tax

    Product price

    It can be displayed only in detail inquiry.

    tax

    Tax amount

    It can be displayed only in detail inquiry.

    product_code

    Product code

    System assigned code. This code cannot be duplicated.

    It can be displayed only in detail inquiry.

    simple_description

    Simple Product Description

    Simple description of product. Can Exposed at product display screen. You may input description with HTML.

    It can be displayed only in detail inquiry.

    summary_description

    Product Summary Description

    Summary description of product. Can Exposed at product display screen. You may input description with HTML.

    It can be displayed only in detail inquiry.

    supplier_name

    Supplier name

    Name of supplier. Supplier name is the basic information for mall to distinguish each supplier.

    It can be displayed only in detail inquiry.

    made_date

    timezone

    Date of manufacture

    Date of manufacture of the product.

    It can be displayed only in detail inquiry.

    review_count

    number of reviews

    It can be displayed only in detail inquiry.

    expiration_date

    Expiration date

    Indicate the expiration date of intangible goods such as gift certificates or tickets or type goods such as food or cosmetics.

    It can be displayed only in detail inquiry.

    coupon_discounted_price

    Coupon-discounted price

    It can be displayed only in detail inquiry.

    trend_name

    Trend name

    Name of trend.

    It can be displayed only in detail inquiry.

    shipping_scope

    Shipping information

    Shows whether can only deliver domestically or can deliver to overseas too.

    Cannot set the type when 'Shipping charge individually' is FALSE.

    It can be displayed only in detail inquiry.

    shipping_fee_type

    Shipping charge

    It can be displayed only in detail inquiry.

    T: Free shipping R: Fixed rate M: Charge according to purchase amount D: Use different shipping charges per different purchase amount W: Use different shipping charges by product weight C: Use different shipping charges by quantity N: Use different shipping charges per different quantity

    shipping_rates

    Charge shipping by section

    It can be displayed only in detail inquiry.

    shipping_fee

    Shipping fee

    It can be displayed only in detail inquiry.

    discount_price

    Discounted price

    It can be displayed only in detail inquiry.

    shipping_method

    Shipping method

    It can be displayed only in detail inquiry.

    promotion_period

    Discount & sales schedule

    It can be displayed only in detail inquiry.

    colors

    Product color

    It can be displayed only in detail inquiry.

    translated_additional_description

    Translated additional description

    It can be displayed only in detail inquiry.

    stock_quantity

    Inventory quantity

    It can be displayed only in detail inquiry.

    question_count

    number of product inquiries

    It can be displayed only in detail inquiry.

    relation_count

    Number of related products

    It can be displayed only in detail inquiry.

    product_material

    Material of product

    It can be displayed only in detail inquiry.

    product_article_count

    number or product boards

    It can be displayed only in detail inquiry.

    additional_information

    Additional information list

    It can be displayed only in detail inquiry.

    payment_methods

    Payment Method

    It can be displayed only in detail inquiry.

    add_products

    Complementary products

    It can be displayed only in detail inquiry.

    Get a productsdetail

    GET

    Specification

    Property Description
    SCOPE mall.read_product
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    mobile

    whether a mobile setup value has been retrieved

    T: Use
    F: Do not use

    Definition Copy

    GET https://{domain}/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    
    GET https://{mallid}.cafe24api.com/api/v2/productsdetail/{product_no}
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/productsdetail/20', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/productsdetail/20' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/productsdetail/20")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/productsdetail/20"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/productsdetail/20',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/productsdetail/20',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/productsdetail/20"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "productsdetail": {
            "shop_no": 1,
            "product_no": 20,
            "detail_image": "http://{domain}/web/product/big/201711/20_shop1_750339.png",
            "small_image": "http://{domain}/web/product/small/201711/20_shop1_750339.png",
            "additional_images": [
                {
                    "big": "http://{domain}/web/product/extra/big/201810/a2803c44ee8299486ff19be239cef7d0.jpg",
                    "medium": "http://{domain}/web/product/extra/medium/201810/a2803c44ee8299486ff19be239cef7d0.jpg",
                    "small": "http://{domain}/web/product/extra/small/201810/a2803c44ee8299486ff19be239cef7d0.jpg"
                },
                {
                    "big": "http://{domain}/web/product/extra/big/201810/e1ab68969d69287a828438c7684b14c4.jpg",
                    "medium": "http://{domain}/web/product/extra/medium/201810/e1ab68969d69287a828438c7684b14c4.jpg",
                    "small": "http://{domain}/web/product/extra/small/201810/e1ab68969d69287a828438c7684b14c4.jpg"
                }
            ],
            "product_name": "iPhone X",
            "manufacturer_name": "APPLE",
            "origin_place_value": "Korea",
            "retail_price": "0.00",
            "price": "11000.00",
            "interest_free_period": null,
            "eng_product_name": "iPhone Ten",
            "custom_product_code": "ABCD",
            "points_amount": [
                {
                    "payment_method": "card",
                    "type": "P",
                    "value": "110.00",
                    "rate": "10.00"
                },
                {
                    "payment_method": "cash",
                    "type": "W",
                    "value": "100.00",
                    "rate": null
                }
            ],
            "brand_name": "BRAND NAME",
            "model_name": "A1865",
            "price_excluding_tax": "10000.00",
            "tax": "1000.00",
            "product_code": "P000000X",
            "simple_description": "This is Product Description.",
            "summary_description": "This is Product Summary.",
            "supplier_name": "SUPPLIER NAME",
            "made_date": "2019-07-11T00:00:00+09:00",
            "review_count": 0,
            "expiration_date": {
                "start_date": "2019-07-08",
                "end_date": "2019-09-14"
            },
            "coupon_discounted_price": "9000.00",
            "trend_name": "TREND NAME",
            "shipping_scope": "Domestic/International shipping",
            "shipping_fee_type": "R",
            "shipping_rates": null,
            "shipping_fee": "2500.00",
            "discount_price": "10500.00",
            "shipping_method": "Courier Service",
            "promotion_period": {
                "start_date": "2019-07-11T00:00:00+09:00",
                "end_date": "2019-07-16T23:55:00+09:00",
                "dc_price": "220.00"
            },
            "colors": [
                "#000000",
                "#C20F0A"
            ],
            "translated_additional_description": "This is a translated additional description of product.",
            "stock_quantity": 10,
            "question_count": 0,
            "product_material": "Aluminum",
            "product_article_count": 0,
            "additional_information": [
                {
                    "key": "custom_option1",
                    "name": "gift option",
                    "value": "Yes"
                },
                {
                    "key": "custom_option1",
                    "name": "benefit option",
                    "value": "Yes"
                }
            ],
            "payment_methods": [
                "cash",
                "mileage"
            ],
            "add_products": [
                14,
                15
            ]
        }
    }
    

    Personal

    Cart

    Cart Resource

    Endpoints

    POST /api/v2/cart
    

    Cart properties

    Attribute Description
    duplicated_item

    Whether the item code in the cart is a duplicate

    Tells whether to allow items with same item codes to added multiple times to cart.
    If allowed, items with same item codes are added.
    If not, items with same item codes are not added to cart.

    T: Item duplicated
    F: Item not duplicated

    variants

    Item

    Variants information. Number and code of variants to create a cart.

    product_no

    Product number

    System assigned code. This code cannot be duplicated.

    basket_type

    Cart type

    Cart type. Cart can be set as interest-free type for products that can be purchased with interest-free payment options.

    A0000: General
    A0001: Interest-free

    prd_detail_ship_fee

    Whether prepaid shipping fee

    Tells whether to collect the shipping rate in advance or upon delivery.

    P: Prepayment
    C: Payment after delivery

    Create a cart

    POST

    Specification

    Property Description
    SCOPE mall.write_personal
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    variants

    Item

    Variants information. Number and code of variants to create a cart.

    addtional_products

    Item of the additional composition product

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    basket_type
    Required

    Cart type

    Cart type. Cart can be set as interest-free type for products that can be purchased with interest-free payment options.

    A0000: General
    A0001: Interest-free

    duplicated_item_check
    Required

    Duplicate check of the cart

    Tells whether to allow items with same item codes to added multiple times to cart.
    If allowed, items with same item codes are added.
    If not, items with same item codes are not added to cart.

    T: Duplicate item check
    F: No duplicate item check

    prefaid_shipping_fee
    Required

    Whether prepaid shipping fee

    Tells whether to collect the shipping rate in advance or upon delivery.

    P: Prepayment
    C: Payment after delivery

    Definition Copy

    POST https://{domain}/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    
    POST https://{mallid}.cafe24api.com/api/v2/cart
    

    Request example: Copy

    (function(CAFE24API) { 
      var data = {
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    };
    
      CAFE24API.post('/api/v2/cart', data, function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X POST \
      'https://{mallid}.cafe24api.com/api/v2/cart' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}' \
      -d '{
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    }'
    
    MediaType mediaType = MediaType.parse("application/json");
    RequestBody body = RequestBody.create(mediaType, "{\n" +
    "    \"request\": {\n" +
    "        \"duplicated_item_check\": \"T\",\n" +
    "        \"product_no\": 950,\n" +
    "        \"basket_type\": \"A0000\",\n" +
    "        \"prefaid_shipping_fee\": \"P\",\n" +
    "        \"variants\": [\n" +
    "            {\n" +
    "                \"quantity\": 1,\n" +
    "                \"variants_code\": \"P0000BJU000H\"\n" +
    "            }\n" +
    "        ]\n" +
    "    }\n" +
    "}");
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/cart")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .post(body)
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/cart"
    
    payload = '''{
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    }'''
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("POST", url, data=payload, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var payload = {
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    };
    
    var options = { method: 'POST',
      url: 'https://{mallid}.cafe24api.com/api/v2/cart',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      },
      body: payload,
      json: true
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $data = '{
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    }';
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/cart',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'POST',
      CURLOPT_POSTFIELDS => $data,
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
        "strings"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/cart"
    
        payload := strings.NewReader(`{
        "request": {
            "duplicated_item_check": "T",
            "product_no": 950,
            "basket_type": "A0000",
            "prefaid_shipping_fee": "P",
            "variants": [
                {
                    "quantity": 1,
                    "variants_code": "P0000BJU000H"
                }
            ]
        }
    }`)
    
        req, _ := http.NewRequest("POST", url, payload)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "cart": [
            {
                "duplicated_item": "T",
                "variants": [
                    {
                        "quantity": 1,
                        "variants_code": "P0000BJU000H"
                    },
                    {
                        "quantity": 2,
                        "variants_code": "P0000BJU000M"
                    }
                ],
                "product_no": 950,
                "basket_type": "A0000",
                "prefaid_shipping_fee": "P"
            }
        ]
    }
    

    Products cart

    Products cart

    Count all products cart

    GET

    Specification

    Property Description
    SCOPE mall.read_personal
    Request Limit 30

    Request

    Parameter Description
    shop_no

    Shop Number

    Multi shopping mall number used for shopping mall classification.

    DEFAULT 1

    product_no
    Required

    Product number

    System assigned code. This code cannot be duplicated.

    Definition Copy

    GET https://{domain}/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    
    GET https://{mallid}.cafe24api.com/api/v2/products/{product_no}/cart/count
    

    Request example: Copy

    (function(CAFE24API) { 
      CAFE24API.get('/api/v2/products/11/cart/count', function (err, res) {
        console.log(res);
      });
    })(CAFE24API.init({
      client_id: '{client_id}',
      version: '{version}'
    }));
    
    curl -X GET \
      'https://{mallid}.cafe24api.com/api/v2/products/11/cart/count' \
      -H 'authorization: Bearer {access_token}' \
      -H 'content-type: application/json' \
      -H 'X-Cafe24-Client-Id: {client_id}' \
      -H 'X-Cafe24-Api-Version: {version}'
    
    Request request = new Request.Builder()
      .url("https://{mallid}.cafe24api.com/api/v2/products/11/cart/count")
      .addHeader("authorization", "Bearer {access_token}")
      .addHeader("content-type", "application/json")
      .addHeader("X-Cafe24-Client-Id", "{client_id}")
      .addHeader("X-Cafe24-Api-Version", "{version}")
      .get()
      .build();
    
    OkHttpClient client = new OkHttpClient();
    Response response = client.newCall(request).execute();
    
    import requests
    
    url = "https://{mallid}.cafe24api.com/api/v2/products/11/cart/count"
    
    headers = {
        'authorization': "Bearer {access_token}",
        'content-type': "application/json",
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
        }
    
    response = requests.request("GET", url, headers=headers)
    
    print(response.text)
    
    var request = require("request");
    
    var options = { method: 'GET',
      url: 'https://{mallid}.cafe24api.com/api/v2/products/11/cart/count',
      headers: {
        authorization: 'Bearer {access_token}',
        'content-type': 'application/json',
        'X-Cafe24-Client-Id': "{client_id}",
        'X-Cafe24-Api-Version': "{version}"
      }
    };
    
    request(options, function (error, response, body) {
      if (error) throw new Error(error);
    
      console.log(body);
    });
    
    <?php
    
    $curl = curl_init();
    
    curl_setopt_array($curl, array(
      CURLOPT_URL => 'https://{mallid}.cafe24api.com/api/v2/products/11/cart/count',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_CUSTOMREQUEST => 'GET',
      CURLOPT_HTTPHEADER => array(
        'authorization: Bearer {access_token}',
        'content-type: application/json',
        'X-Cafe24-Client-Id: {client_id}',
        'X-Cafe24-Api-Version: {version}'
      ),
    ));
    
    $response = curl_exec($curl);
    $err = curl_error($curl);
    
    if ($err) {
      echo 'cURL Error #:' . $err;
    } else {
      echo $response;
    }
    
    package main
    
    import (
        "fmt"
        "net/http"
        "io/ioutil"
    )
    
    func main() {
        url := "https://{mallid}.cafe24api.com/api/v2/products/11/cart/count"
    
        req, _ := http.NewRequest("GET", url, nil)
    
        req.Header.Add("authorization", "Bearer {access_token}")
        req.Header.Add("content-type", "application/json")
        req.Header.Add("X-Cafe24-Client-Id", "{client_id}")
        req.Header.Add("X-Cafe24-Api-Version", "{version}")
        res, _ := http.DefaultClient.Do(req)
    
        defer res.Body.Close()
        body, _ := ioutil.ReadAll(res.Body)
    
        fmt.Println(res)
        fmt.Println(string(body))
    }
    

    Response example:

    {
        "count": 7
    }
    
    Top