Subjects v3

CRUD operations product form features. Product Form Features specifies the features of a product form, e.g. color of the spine of a printed book or accessibility details for ebooks.

Endpoints

GET /resource/v3/products/{product_id}/form_features

List Product Form Features

Input parameters

Parameter	In	Type	Default	Nullable	Description
`product_type`	query	string		No	Filter by product_type ('ebook', 'book', 'audiobook', 'software')
`type`	query	string		No	Filter by ProductFormFeatureType (ONIX Codelist 79)

Response 200 OK

application/json

[
    {
        "_id": 10,
        "description": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n",
        "product_type": "ebook",
        "type": "09",
        "value": "00"
    }
]

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "type": "array",
    "items": {
        "$ref": "#/components/schemas/ProductFormFeature"
    }
}

POST /resource/v3/products/{product_id}/form_features

Create a Product Form Feature

Input parameters

Parameter	In	Type	Default	Nullable	Description
`product_id`	path	string		No

Request body

application/json

{
    "_id": 10,
    "description": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n",
    "product_type": "ebook",
    "type": "09",
    "value": "00"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body

{
    "type": "object",
    "properties": {
        "_id": {
            "type": "integer",
            "example": 10
        },
        "description": {
            "type": "string",
            "example": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n"
        },
        "product_type": {
            "type": "string",
            "example": "ebook"
        },
        "type": {
            "type": "string",
            "description": "ProductFormFeatureType from ONIX Codelist 79",
            "example": "09"
        },
        "value": {
            "type": "string",
            "description": "ProductFormFeatureValue from ONIX (dependent on 'type')",
            "example": "00"
        }
    },
    "required": [
        "type",
        "value",
        "product_type"
    ]
}

Response 201 Created

GET /resource/v3/products/{product_id}/form_features/{feature_id}

Get a Product Form Feature

Input parameters

Parameter	In	Type	Default	Nullable	Description
`feature_id`	path	integer		No
`product_id`	path	string		No

Response 200 OK

application/json

{
    "_id": 10,
    "description": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n",
    "product_type": "ebook",
    "type": "09",
    "value": "00"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "type": "object",
    "properties": {
        "_id": {
            "type": "integer",
            "example": 10
        },
        "description": {
            "type": "string",
            "example": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n"
        },
        "product_type": {
            "type": "string",
            "example": "ebook"
        },
        "type": {
            "type": "string",
            "description": "ProductFormFeatureType from ONIX Codelist 79",
            "example": "09"
        },
        "value": {
            "type": "string",
            "description": "ProductFormFeatureValue from ONIX (dependent on 'type')",
            "example": "00"
        }
    },
    "required": [
        "type",
        "value",
        "product_type"
    ]
}

PUT /resource/v3/products/{product_id}/form_features/{feature_id}

Update a Product Form Feature

Input parameters

Parameter	In	Type	Default	Nullable	Description
`feature_id`	path	integer		No
`product_id`	path	string		No

Request body

application/json

{
    "_id": 10,
    "description": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n",
    "product_type": "ebook",
    "type": "09",
    "value": "00"
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body

{
    "type": "object",
    "properties": {
        "_id": {
            "type": "integer",
            "example": 10
        },
        "description": {
            "type": "string",
            "example": "This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.\n"
        },
        "product_type": {
            "type": "string",
            "example": "ebook"
        },
        "type": {
            "type": "string",
            "description": "ProductFormFeatureType from ONIX Codelist 79",
            "example": "09"
        },
        "value": {
            "type": "string",
            "description": "ProductFormFeatureValue from ONIX (dependent on 'type')",
            "example": "00"
        }
    },
    "required": [
        "type",
        "value",
        "product_type"
    ]
}

Response 200 OK

DELETE /resource/v3/products/{product_id}/form_features/{feature_id}

Delete a Product Form Feature

Input parameters

Parameter	In	Type	Default	Nullable	Description
`feature_id`	path	integer		No
`product_id`	path	string		No

Response 204 No Content

Schemas

ProductFormFeature

Name	Type
`_id`	integer Example: `10`
`description`	string Example: `This publication is generally accessible but there are no alternative texts for images. Images are described in detail in the surrounding text.`
`product_type`	string Example: `ebook`
`type`	string ProductFormFeatureType from ONIX Codelist 79 Example: `09`
`value`	string ProductFormFeatureValue from ONIX (dependent on 'type') Example: `00`