Merge pull request #181 from akeneo/API_543

Add media file on product models

Author: NolwennP

content/swagger/resources/media_files/routes/media_files.yaml

@@ -117,7 +117,7 @@ get:
 post:
   summary: Create a new media file
   operationId: "post_media_files"
-  description: This endpoint allows you to create a new media file and associate it to the product value of a given product.
+  description: This endpoint allows you to create a new media file and associate it to an attribute value of a given product or product model.
   tags:
     - Media files
   x-versions:
@@ -133,10 +133,14 @@ post:
       in: body
       x-form-data: true
       schema:
+        required: ["file"]
         properties:
           product:
             type: string
-            description: The product to which the media file will be associated. It is a JSON string that follows this formula '{"identifier":"product_identifier", "attribute":"attribute_code", "scope":"channel_code","locale":"locale_code"}'
+            description: The product to which the media file will be associated. It is a JSON string that follows this format '{"identifier":"product_identifier", "attribute":"attribute_code", "scope":"channel_code","locale":"locale_code"}'. You have to either use this field or the `product_model` field, but not both at the same time.
+          product_model:
+            type: string
+            description: The product model to which the media file will be associated. It is a JSON string that follows this format '{"code":"product_model_code", "attribute":"attribute_code", "scope":"channel_code","locale":"locale_code"}'. You have to either use this field or the `product` field, but not both at the same time.
           file:
             type: string
             description: The binaries of the file

content/swagger/resources/token.yaml

@@ -24,6 +24,7 @@ post:
       x-form-data: true
       schema:
         type: object
+        required: ["username", "password", "grant_type"]
         properties:
           username:
             type: string

src/api-reference/reference.handlebars

@@ -162,7 +162,9 @@
                                                                 {{#each schema.properties}}
                                                                     <p>
                                                                         <code>{{@key}}</code>
-                                                                        <a href="#" data-placement="top" data-toggle="tooltip" title="Required property"><i class="fa fa-asterisk fa-danger"></i></a>
+                                                                        {{#if required}}
+                                                                            <a href="#" data-placement="top" data-toggle="tooltip" title="Required property"><i class="fa fa-asterisk fa-danger"></i></a>
+                                                                        {{/if}}
                                                                         <em>({{{type}}} {{#if format}} / {{{format}}}{{/if}})</em>
                                                                         <small>&bull; {{description}}</small>
                                                                     </p>