POST production-spec

Used to create a specification. This will be called with an array of specifications to add, the arrays must include all required fields.

When accessed via a POST request this API method will create a new specification. Your HTTP body should consist of JSON similar to the following sample.

Each attribute type/value will be validated to ensure that the data is valid. See the section on errors for how errors are represented.

INPUT

As this method is accessed via a POST request the raw body must be set to JSON as described below.


[{
    "Name": "Specification Name",
    "Type": "STATIC",
    "MediaOwnerRef": "REF 1",
    "Description": "Lorem Ipsum dolor sit amet",
    "Url": "https://www.oohspace.co.uk/api/documentation/production-spec-post",
    "DisplayAreaHeight": 4000,
    "DisplayAreaWidth": 8000,
    "MaxFileSize": "2000",
    "OverallSizeHeight": 1,
    "OverallSizeWidth": 2,
    "Material": "Vinyl",
    "Finishing": "Test",
    "Packing": "Test",
    "Spares": "Test",
    "CreativeMaxSize": 1000,
    "CreativeMimeTypes": ".pdf",
    "CreativeHeightMin": 100,
    "CreativeHeightMax": 100,
    "CreativeWidthMin": 100,
    "CreativeWidthMax": 100,
    "CreativeDpiMin": 600,
    "CreativeBleed": 150,
    "CreativePixelsHeightMin": 4000,
    "CreativePixelsHeightMax": 800,
    "CreativePixelsWidthMin": 2000,
    "CreativePixelsWidthMax": 4000,
    "Motion": "static",
    "LengthMin": 25.0,
    "LengthMax": 50.0
}]
        

The table below details the fields used in this example.

parameter type description
Name string (required) A unique name for the specification. Must be less than 100 characters
Type string (required) The type of frame that can be linked to this specification. The value must be either 'DIGITAL' or 'STATIC'
MediaOwnerRef string (optional) An internal reference for the specification. Only visible to the specification owner and SPACE admin
Description string (optional) A description of the specification
Url string (optional) [url] URL to public document of Production Spec
DisplayAreaHeight integer (optional) [mm] Display Area Height
DisplayAreaWidth integer (optional) [mm] Display Area Width
VideoBitRate string (optional)
OverallSizeHeight integer (optional) [mm] Overall size of printed material (Height)
OverallSizeWidth integer (optional) [mm] Overall size of printed material (Width)
Material string (optional) Description of the material to be provided
Finishing string (optional)
Packing string (optional)
Spares string (optional)
CreativeMaxSize integer (optional) [Mb] Maximum file size when providing creative
CreativeMimeTypes string (optional) List of mime types of files that will be accepted when providing the creative
One or more of [ '.ai', '.avi', '.bin', '.bmp', '.doc', '.eps', '.exe', '.gif', '.gzip', '.jpe', '.jpeg', '.jpg', '.mov', '.mpe', '.mpeg', '.mpg', '.pdf', '.png', '.ps', '.qt', '.tif', '.tiff', '.viv', '.vivo', '.xbm', '.zip' ]
CreativeHeightMin integer (optional) [mm] Minimum Height of Creative
CreativeHeightMax integer (optional) [mm] Maximum Height of Creative
CreativeWidthMin integer (optional) [mm] Minimum Width of Creative
CreativeWidthMax integer (optional) [mm] Maximum Width of Creative
CreativeDpiMin integer (optional) [dpi] Minimum dots per inch of creative
CreativeBleed integer (optional) [mm]
CreativePixelsHeightMin integer (required for digital. optional for static) [pixels] Minimum Height in Pixels of Creative
CreativePixelsHeightMax integer (required for digital. optional for static) [pixels] Maximum Height in Pixels of Creative
CreativePixelsWidthMin integer (required for digital. optional for static) [pixels] Minimum Width in Pixels of Creative
CreativePixelsWidthMax integer (required for digital. optional for static) [pixels] Maximum Width in Pixels of Creative
Motion string (optional) The level of motion supported [static, full_motion, subtle_motion]
One of [ 'static', 'full_motion', 'subtle_motion' ]
LengthMin float (optional) [seconds] Minimum length of moving content
LengthMax float (optional) [seconds] Maximum length of moving content

OUTPUT - JSON sample

If accessing POST /api/production-spec with the body set to the sample JSON above then the following JSON would be returned:


[
    {
        "ProductionSpecificationID": 77,
        "Name": "Specification Name",
        "Type": "STATIC",
        "Version": 1,
        "LastUpdated": "2023-02-06 10:30:11",
        "MediaOwnerID": 1,
        "MediaOwner": "Mediatel",
        "MediaOwnerRef": "REF 1",
        "Description": "Lorem Ipsum dolor sit amet",
        "Url": "https://www.oohspace.co.uk/api/documentation/production-spec-post",
        "DisplayAreaHeight": 4000,
        "DisplayAreaWidth": 8000,
        "MaxFileSize": "2000",
        "OverallSizeHeight": 1,
        "OverallSizeWidth": 2,
        "Material": "Vinyl",
        "Finishing": "Test",
        "Packing": "Test",
        "Spares": "Test",
        "CreativeMaxSize": 1000,
        "CreativeMimeTypes": ".pdf",
        "CreativeHeightMin": 100,
        "CreativeHeightMax": 100,
        "CreativeWidthMin": 100,
        "CreativeWidthMax": 100,
        "CreativeDpiMin": 600,
        "CreativeBleed": 150,
        "CreativePixelsHeightMin": 4000,
        "CreativePixelsHeightMax": 800,
        "CreativePixelsWidthMin": 2000,
        "CreativePixelsWidthMax": 4000,
        "Motion": "static",
        "LengthMin": 25,
        "LengthMax": 50
    }
]
        

A "data" element that contains an array of Production/Creative Specifications as defined within the response for GET /api/production-spec