Jump to

• Request
• Response

Insert facet value records into record collection

post

/gsdata/v1/{appName}/facets/{recordCollection}

Insert records into the specified record collection. If record with the same key and locale already exist in the collection it will be overwritten. Changing records (whether adding, deleting or updating) requires a baseline index for the changes to take effect. Users must not manipulate system created record collections, eg records in /cloud/facets/product.category or product.priceRange, as these changes would be overwritten on the next catalog indexing event.

Request

Supported Media Types

• application/json

Path Parameters

• appName: string
  Specifies the name of your application. For example, "cloud".
• recordCollection: string
  Name of the record collection. A valid record collection name is defined by the regular expression "^[a-zA-Z0-9._-]+$" and cannot exceed 128 characters.

Body ()

Represents a facet order list.

Root Schema : FacetList

Type: object

Represents a facet order list.

Show Source

• contentItem: object contentItem
• ecr:createDate(optional): string
• ecr:lastModified(optional): string
• ecr:lastModifiedBy(optional): string
• ecr:type: string
  Default Value: content-item

  Allowed Values: [ "content-item" ]
• priority: integer(int32)
• triggers: array triggers
• workflowState(optional): string

{
    "type":"object",
    "required":[
        "contentItem",
        "ecr:type",
        "priority",
        "triggers"
    ],
    "properties":{
        "ecr:type":{
            "type":"string",
            "default":"content-item",
            "enum":[
                "content-item"
            ]
        },
        "contentItem":{
            "type":"object",
            "properties":{
                "navigation":{
                    "type":"array",
                    "items":{
                        "type":"object",
                        "properties":{
                            "@type":{
                                "type":"string",
                                "default":"RefinementMenu",
                                "enum":[
                                    "RefinementMenu"
                                ]
                            },
                            "dimensionName":{
                                "type":"string"
                            }
                        },
                        "required":[
                            "@type",
                            "dimensionName"
                        ]
                    }
                },
                "showAll":{
                    "type":"boolean"
                },
                "@type":{
                    "type":"string",
                    "default":"GuidedNavigation"
                }
            },
            "required":[
                "@type",
                "navigation"
            ]
        },
        "priority":{
            "type":"integer",
            "format":"int32"
        },
        "triggers":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "exactLocation":{
                        "type":"boolean"
                    },
                    "searchTerms":{
                        "type":"string",
                        "description":"Specifies the search terms based location in the storefront where the facet list is to be used."
                    },
                    "matchmode":{
                        "type":"string",
                        "description":"Specifies the match mode to use for the search terms. The value should be one of the following: MATCHPHRASE, MATCHEXACT, MATCHALL."
                    },
                    "dvalIDs":{
                        "type":"array",
                        "description":"Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.",
                        "items":{
                            "type":"string"
                        }
                    }
                }
            }
        },
        "ecr:createDate":{
            "type":"string"
        },
        "ecr:lastModified":{
            "type":"string"
        },
        "ecr:lastModifiedBy":{
            "type":"string"
        },
        "workflowState":{
            "type":"string"
        }
    },
    "description":"Represents a facet order list."
}

Nested Schema : contentItem

Type: object

Show Source

• @type: string
  Default Value: GuidedNavigation
• navigation: array navigation
• showAll(optional): boolean

{
    "type":"object",
    "properties":{
        "navigation":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "@type":{
                        "type":"string",
                        "default":"RefinementMenu",
                        "enum":[
                            "RefinementMenu"
                        ]
                    },
                    "dimensionName":{
                        "type":"string"
                    }
                },
                "required":[
                    "@type",
                    "dimensionName"
                ]
            }
        },
        "showAll":{
            "type":"boolean"
        },
        "@type":{
            "type":"string",
            "default":"GuidedNavigation"
        }
    },
    "required":[
        "@type",
        "navigation"
    ]
}

Nested Schema : triggers

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "exactLocation":{
                "type":"boolean"
            },
            "searchTerms":{
                "type":"string",
                "description":"Specifies the search terms based location in the storefront where the facet list is to be used."
            },
            "matchmode":{
                "type":"string",
                "description":"Specifies the match mode to use for the search terms. The value should be one of the following: MATCHPHRASE, MATCHEXACT, MATCHALL."
            },
            "dvalIDs":{
                "type":"array",
                "description":"Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.",
                "items":{
                    "type":"string"
                }
            }
        }
    }
}

Nested Schema : navigation

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "@type":{
                "type":"string",
                "default":"RefinementMenu",
                "enum":[
                    "RefinementMenu"
                ]
            },
            "dimensionName":{
                "type":"string"
            }
        },
        "required":[
            "@type",
            "dimensionName"
        ]
    }
}

Nested Schema : items

Type: object

Show Source

• @type: string
  Default Value: RefinementMenu

  Allowed Values: [ "RefinementMenu" ]
• dimensionName: string

{
    "type":"object",
    "properties":{
        "@type":{
            "type":"string",
            "default":"RefinementMenu",
            "enum":[
                "RefinementMenu"
            ]
        },
        "dimensionName":{
            "type":"string"
        }
    },
    "required":[
        "@type",
        "dimensionName"
    ]
}

Nested Schema : items

Type: object

Show Source

• dvalIDs(optional): array dvalIDs
  Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.
• exactLocation(optional): boolean
• matchmode(optional): string
  Specifies the match mode to use for the search terms. The value should be one of the following: MATCHPHRASE, MATCHEXACT, MATCHALL.
• searchTerms(optional): string
  Specifies the search terms based location in the storefront where the facet list is to be used.

{
    "type":"object",
    "properties":{
        "exactLocation":{
            "type":"boolean"
        },
        "searchTerms":{
            "type":"string",
            "description":"Specifies the search terms based location in the storefront where the facet list is to be used."
        },
        "matchmode":{
            "type":"string",
            "description":"Specifies the match mode to use for the search terms. The value should be one of the following: MATCHPHRASE, MATCHEXACT, MATCHALL."
        },
        "dvalIDs":{
            "type":"array",
            "description":"Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : dvalIDs

Type: array

Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.

Show Source

• Array of: string

{
    "type":"array",
    "description":"Specifies a list of locations (facet or facet value IDs) in the storefront where the facet list is to be used.",
    "items":{
        "type":"string"
    }
}

Security

• basicAuth: basic
  Type: basic

  Description: Basic username/password authentication.

Back to Top

Response

Supported Media Types

• application/json

201 Response

POST request was successful.

Body ()

Root Schema : PostRecordsResponse

Type: object

Represents the response received from a POST request to insert records into record collection.

Show Source

• importRecordsStatus(optional): object ImportRecordsStatus
  Represents a status of records being imported by this POST request.
• importRecordsSummary(optional): object ImportRecordsSummary
  Represents a summary of records imported by this POST request.
• links(optional): array links
• status(optional): integer
• title(optional): string

{
    "type":"object",
    "properties":{
        "status":{
            "type":"integer"
        },
        "title":{
            "type":"string"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        },
        "importRecordsSummary":{
            "$ref":"#/definitions/ImportRecordsSummary"
        },
        "importRecordsStatus":{
            "$ref":"#/definitions/ImportRecordsStatus"
        }
    },
    "description":"Represents the response received from a POST request to insert records into record collection."
}

Nested Schema : ImportRecordsStatus

Type: object

Represents a status of records being imported by this POST request.

Show Source

• numCommits(optional): integer
• numRecordsCommitted(optional): integer
• numRecordsInQueue(optional): integer
• numRecordsPendingCommit(optional): integer

{
    "type":"object",
    "properties":{
        "numRecordsInQueue":{
            "type":"integer"
        },
        "numRecordsPendingCommit":{
            "type":"integer"
        },
        "numRecordsCommitted":{
            "type":"integer"
        },
        "numCommits":{
            "type":"integer"
        }
    },
    "description":"Represents a status of records being imported by this POST request."
}

Nested Schema : ImportRecordsSummary

Type: object

Represents a summary of records imported by this POST request.

Show Source

• numRecordsInvalid(optional): integer
• numRecordsProcessed(optional): integer
• numRecordsStatus(optional): integer

{
    "type":"object",
    "properties":{
        "numRecordsProcessed":{
            "type":"integer"
        },
        "numRecordsInvalid":{
            "type":"integer"
        },
        "numRecordsStatus":{
            "type":"integer"
        }
    },
    "description":"Represents a summary of records imported by this POST request."
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link
  Represents a link to a gsdata resource.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

Nested Schema : Link

Type: object

Represents a link to a gsdata resource.

Show Source

• href(optional): string
• rel(optional): string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "description":"Represents a link to a gsdata resource."
}

Back to Top