{ "openapi": "3.1.0", "info": { "title": "API Settings", "version": "1.0" }, "servers": [ { "url": "https://app.salsify.com/api/v1/orgs" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/{org_id}/digital_assets/{asset_id}": { "get": { "summary": "Read Digital Asset Metadata", "description": "Where a user has permission and the digital asset exists, complete digital asset JSON object is returned with its most current information.", "operationId": "get-digital-asset", "parameters": [ { "name": "org_id", "in": "path", "description": "The Salsify organization's unique identifier. Visit your Salsify organization and pull from the URL path, immediately following /orgs/.", "required": true, "schema": { "type": "string" } }, { "name": "asset_id", "in": "path", "description": "Digital asset unique identifier.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"salsify:id\": \"01d954267e703cb8f9a73c50928e4ca8ed98e115\",\n \"salsify:url\": \"http://images.salsify.com/image/upload/s--CJemutyy--/cnpfpnp48unsd3n0ok5e.jpg\",\n \"salsify:name\": \"pink_leather_tote.jpg\",\n \"salsify:created_at\": \"2016-02-28T00:04:47.191Z\",\n \"salsify:updated_at\": \"2017-05-21T05:18:34.244Z\",\n \"salsify:status\": \"completed\",\n \"salsify:asset_height\": 2795,\n \"salsify:asset_width\": 2795,\n \"salsify:asset_resource_type\": \"image\",\n \"salsify:filename\": \"pink_leather_tote.jpg\",\n \"salsify:bytes\": 1885251,\n \"salsify:format\": \"jpg\",\n \"salsify:etag\": \"5e212cf4ae709184aff2b35ec2d97278\",\n \"salsify:system_id\": \"s-9999-9999-99999\",\n \"Asset Keywords\": [\n \"front view\",\n \"white isolation\",\n \"leather tote\"\n ],\n \"Asset Color\": \"Blush\",\n \"Asset Created Date \": \"2016-05-02\",\n \"Asset Photographer\": \"LB Jeffreys\",\n \"Manufacturer\": \"Wildflower Imports, Inc.\"\n}" } }, "schema": { "type": "object", "properties": { "salsify:id": { "type": "string", "example": "01d954267e703cb8f9a73c50928e4ca8ed98e115" }, "salsify:url": { "type": "string", "example": "http://images.salsify.com/image/upload/s--CJemutyy--/cnpfpnp48unsd3n0ok5e.jpg" }, "salsify:name": { "type": "string", "example": "pink_leather_tote.jpg" }, "salsify:created_at": { "type": "string", "example": "2016-02-28T00:04:47.191Z" }, "salsify:updated_at": { "type": "string", "example": "2017-05-21T05:18:34.244Z" }, "salsify:status": { "type": "string", "example": "completed" }, "salsify:asset_height": { "type": "integer", "example": 2795, "default": 0 }, "salsify:asset_width": { "type": "integer", "example": 2795, "default": 0 }, "salsify:asset_resource_type": { "type": "string", "example": "image" }, "salsify:filename": { "type": "string", "example": "pink_leather_tote.jpg" }, "salsify:bytes": { "type": "integer", "example": 1885251, "default": 0 }, "salsify:format": { "type": "string", "example": "jpg" }, "salsify:etag": { "type": "string", "example": "5e212cf4ae709184aff2b35ec2d97278" }, "salsify:system_id": { "type": "string", "example": "s-9999-9999-99999" }, "Asset Keywords": { "type": "array", "items": { "type": "string", "example": "front view" } }, "Asset Color": { "type": "string", "example": "Blush" }, "Asset Created Date ": { "type": "string", "example": "2016-05-02" }, "Asset Photographer": { "type": "string", "example": "LB Jeffreys" }, "Manufacturer": { "type": "string", "example": "Wildflower Imports, Inc." } } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": \"You need to sign in before continuing.\"\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "string", "example": "You need to sign in before continuing." } } } } } }, "404": { "description": "404", "content": { "text/plain": { "examples": { "Result": { "value": "Asset ID does not exist in Salsify." } } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "curl", "code": "curl -X GET \\\n https://app.salsify.com/api/v1/orgs/s-999-999-999-999/digital_assets/01d954267e703cb8f9a73c50928e4ca8ed98e115 \\\n -H 'authorization: Bearer YOUR-AUTH-TOKEN' \\\n\n# where org_id = s-999-999-999-999, asset_id = 01d954267e703cb8f9a73c50928e4ca8ed98e115, and api_token = YOUR-AUTH-TOKEN\n" }, { "language": "ruby", "code": "require 'uri'\nrequire 'net/http'\n\nurl = URI(\"https://app.salsify.com/api/v1/orgs/s-999-999-999-999/digital_assets/01d954267e703cb8f9a73c50928e4ca8ed98e115\")\n\nhttp = Net::HTTP.new(url.host, url.port)\nhttp.use_ssl = true\nhttp.verify_mode = OpenSSL::SSL::VERIFY_NONE\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"authorization\"] = 'Bearer YOUR-AUTH-TOKEN'\n\nresponse = http.request(request)\nputs response.read_body\n\n# where org_id = s-999-999-999-999, asset_id = 01d954267e703cb8f9a73c50928e4ca8ed98e115, and api_token = YOUR-AUTH-TOKEN" }, { "language": "python", "code": "import http.client\n\nconn = http.client.HTTPSConnection(\"app.salsify.com\")\n\nheaders = {\n 'authorization': \"Bearer YOUR-AUTH-TOKEN\"\n }\n\nconn.request(\"GET\", \"/api/v1/orgs/s-999-999-999-999/digital_assets/01d954267e703cb8f9a73c50928e4ca8ed98e115\", headers=headers)\n\nres = conn.getresponse()\ndata = res.read()\n\nprint(data.decode(\"utf-8\"))\n\n# where org_id = s-999-999-999-999, asset_id = 01d954267e703cb8f9a73c50928e4ca8ed98e115, and api_token = YOUR-AUTH-TOKEN" } ], "samples-languages": [ "curl", "ruby", "python" ] } } }, "/{org_id}/products/{salsify:id}": { "get": { "summary": "Read Product Record", "description": "", "operationId": "read-product-record", "parameters": [ { "name": "org_id", "in": "path", "description": "Salsify organization's unique identifier. Visit your Salsify organization and pull from the URL path, immediately following /orgs/", "schema": { "type": "string" }, "required": true }, { "name": "salsify:id", "in": "path", "description": "Salsify product ID", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"salsify:id\": \"102918\",\n \"salsify:created_at\": \"2016-02-29T20:42:44.488Z\",\n \"salsify:updated_at\": \"2017-11-28T17:24:45.515Z\",\n \"salsify:version\": 61,\n \"salsify:relations_updated_at\": \"2016-11-07T20:09:53.188Z\",\n \"salsify:profile_asset_id\": null,\n \"salsify:parent_id\": \"MCS269\",\n \"salsify:system_id\": \"s-999-999-999-999\",\n \"Product ID\": \"102918\",\n \"Product Name\": \"Jetsetter Carry On Roller - Purple\",\n \"Main Image\": \"8d538dcbfd2d5547f7080f2408e7457e96c0451a\",\n \"UPC\": \"143287212918\",\n \"Certifications\": \"TSA-Approved\",\n \"Assembly Country of Origin\": \"US\",\n \"Component Country of Origin\": \"China\",\n \"Warnings\": \"
WARNING: To avoid danger of suffocation, keep inner plastic bag away from babies and children. Do not use bag in cribs, beds, carriages or play pens. This bag is not a toy.
\",\n \"Active Date\": [\n \"2015-05-01\",\n \"2017-10-17\"\n ],\n \"HTML Description\": \"The 21\\\" Spinner is part of the Jetsetter Collection. Pack away any travel worries and woes with the efficient design of the Jettsetter rolling bag. Features top and side carrying handles for easy lifting, dual-tube handle with push-button extension. Maneuvers easily on four 360 degree wheels. Easy upright rolling for minimal arm strain. Jetset in style!
\\nWARNING: To avoid danger of suffocation, keep inner plastic bag away from babies and children. Do not use bag in cribs, beds, carriages or play pens. This bag is not a toy.
" }, "Active Date": { "type": "array", "items": { "type": "string", "example": "2015-05-01" } }, "HTML Description": { "type": "string", "example": "The 21\" Spinner is part of the Jetsetter Collection. Pack away any travel worries and woes with the efficient design of the Jettsetter rolling bag. Features top and side carrying handles for easy lifting, dual-tube handle with push-button extension. Maneuvers easily on four 360 degree wheels. Easy upright rolling for minimal arm strain. Jetset in style!
\nWARNING: To avoid danger of suffocation, keep inner plastic bag away from babies and children. Do not use bag in cribs, beds, carriages or play pens. This bag is not a toy.
\",\n \"Active Date\": [\n \"2015-05-01\",\n \"2017-10-17\"\n ],\n \"HTML Description\": \"The 21\\\" Spinner is part of the Jetsetter Collection. Pack away any travel worries and woes with the efficient design of the Jettsetter rolling bag. Features top and side carrying handles for easy lifting, dual-tube handle with push-button extension. Maneuvers easily on four 360 degree wheels. Easy upright rolling for minimal arm strain. Jetset in style!
\\nWARNING: To avoid danger of suffocation, keep inner plastic bag away from babies and children. Do not use bag in cribs, beds, carriages or play pens. This bag is not a toy.
" }, "Active Date": { "type": "array", "items": { "type": "string", "example": "2015-05-01" } }, "HTML Description": { "type": "string", "example": "The 21\" Spinner is part of the Jetsetter Collection. Pack away any travel worries and woes with the efficient design of the Jettsetter rolling bag. Features top and side carrying handles for easy lifting, dual-tube handle with push-button extension. Maneuvers easily on four 360 degree wheels. Easy upright rolling for minimal arm strain. Jetset in style!
\n