Merge pull request #1346 from mjger/issue/UNITY-9702-availability-notification-doc

UNKTY-9702: availability notfication docs

Author: dkluever22

_raml/apps/products/examples/post_product_productid_availability_notifications_request.json

@@ -0,0 +1,4 @@
+{
+  "email": "john@doe.com",
+  "locale": "de_DE"
+}

_raml/apps/products/products.raml

@@ -146,6 +146,18 @@ post:
     responses:
       204:
 
+  /availability-notifications:
+    displayName: Product Availability Notification
+    post:
+      description: Enables the availability notification for the given product and customer email address. The language of the notification is based on the locale of the customer's storefront. *epagesNow
+      securedBy: [products_write]
+      body:
+        application/json:
+          example: !include examples/post_product_productid_availability_notifications_request.json
+          schema: !include schema/post_product_productid_availability_notifications.schema.json
+      responses:
+        200:
+
   /crossselling:
     displayName: Product crossselling
     get:

_raml/apps/products/schema/post_product_productid_availability_notifications.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-03/schema",
+  "title": "POST Availability Schema",
+  "type": "object",
+  "properties": {
+    "email": {
+      "type": "string",
+      "description": "email address"
+    },
+    "locale": {
+      "type": "string",
+      "description": "ISO 8859-1 Locale ID"
+    }
+  }
+}