• Marketplace

marketplace
  1. Help Center
  2. Marketplace
  3. API Reference
  4. Applying for a product
  5. Viewing Product Applications

Viewing Product Applications

Function

This interface is used to view product applications.

URI

  • URI format

    GET /v1/{isv_id}/applies{?status,start_number,apply_type,limit,from,to,product_name,isv_name}

    NOTE:

    Enter a question mark (?) and an ampersand (&) at the end of the URI to define multiple search criteria. You can filter all non-mandatory parameters in parameter descriptions.

  • Parameter descriptions

    Parameter

    Mandatory

    Type

    Description

    isv_id

    Yes

    String

    Specifies an ISV ID.

    status

    No

    String

    Specifies a request status:

    • under_review: indicates that the application is being reviewed.
    • review_failed: indicates that the application is rejected.
    • approved: indicates that the application was approved.

    By default, applications of all statuses are viewed.

    start_number

    No

    Number

    Specifies the start line number, which defaults to 0.

    limit

    No

    Number

    Specifies the number of returned items. The value ranges from 1 to 100 and is 10 by default. If a value greater than 100 is entered, the system will take 100 instead.

    from

    No

    String

    Specifies the start time in timestamp format. If the format is incorrect, the returned value is null. The start time is not limited by default.

    to

    No

    String

    Specifies the end time in timestamp format. If the format is incorrect, the returned value is null. The end time is not limited by default.

    apply_type

    No

    String

    Specifies the application type.

    • new: The application is newly published.
    • modify: The application is modified.

    By default, applications of all types are viewed.

    product_name

    No

    String

    Specifies a product name, which cannot exceed 50 characters.

    isv_name

    No

    String

    Specifies an ISV name, which cannot exceed 50 characters.

    language

    No

    String

    Specifies a language, which defaults to en_US.

    • en_US: English
    • zh_CN: Chinese
  • Example
    /v1/{isv_id}/applies?status=under_review
    /v1/{isv_id}/applies?status=under_review&limit=10&start_number=1&from=1442347449274&to=1442390649274&product_name=app

Request

None

Response

  • Parameter descriptions

    Parameter

    Type

    Description

    total_number

    Integer

    Specifies the total number of view records.

    start_number

    Integer

    Specifies a start line number.

    limit

    Integer

    Specifies the maximum number of view records.

    products

    List<Product>

    Specifies products.

  • Product parameter descriptions

    Parameter

    Mandatory

    Type

    Description

    id

    Yes

    String

    Specifies a request ID.

    name

    Yes

    String

    Specifies a product name.

    mode

    Yes

    Number

    Specifies a product mode. The value can be 1, indicating that the type is image.

    category

    Yes

    Number

    Specifies a product category ID.

    category_desc

    No

    String

    Describes a product category.

    status

    No

    String

    Specifies a product status.

    • under_review: indicates that the application is being reviewed.
    • review_failed: indicates the application was rejected.
    • approved: indicates that the application was approved.

    By default, applications of all types are viewed.

    apply_time

    Yes

    String

    Specifies the product application time, which is in timestamp format.

    apply_type

    Yes

    String

    Specifies the application type.

    • new: The application is newly published.
    • modify: The application is modified.

    isv_id

    Yes

    String

    Specifies an ISV ID.

    isv_name

    Yes

    String

    Specifies an ISV name.

  • Example
    {
      "products": [
        {
          "id": "863b6a2e-1c7a-4284-b715-07c94367ffc7",
          "name": "marketplace product-0417-1",
          "mode": 1,
          "category": 101,
          "status": "under_review",
          "apply_type": "new",
          "apply_time": 1492409195000,
          "category_desc": "Operating system",
          "isv_id": "05ed4921f5b94dc998bbc4406f4aad2c",
          "isv_name": "zwx285972-201704211504"
        }
      ],
      "total_number": 1,
      "start_number": 0,
      "limit": 10
    }

Returned Value

  • Normal

    200

  • Abnormal

    Returned Value

    Description

    400 Bad Request

    Request error.

    401 Unauthorized

    The authentication information has not been provided or is incorrect.

    403 Forbidden

    The request was forbidden.

    404 Not Found

    The requested page was not found.

    405 Method Not Allowed

    You are not allowed to use the method specified in the request.

    408 Request Timeout

    The request timed out.

    500 Internal Server Error

    Failed to complete the request because an internal service error occurred.

    503 Service Unavailable

    Failed to complete the request because the system is currently unavailable.