MAGETWO-32622: Define Public API

 - MAGETWO-37129:  [TD] Samples and Links is mixed in API - fix Code Style

Author: Andrii Kasian

dev/tests/api-functional/testsuite/Magento/Downloadable/Api/LinkRepositoryTest.php

@@ -920,26 +920,12 @@ public function getListForAbsentProductProvider()
             ]
         ];
 
-        $sampleExpectation = [
-            'fields' => [
-                'title' => 'Downloadable Product Sample Title',
-                'sort_order' => 0,
-                'sample_file' => '/f/u/jellyfish_1_4.jpg',
-                'sample_type' => 'file'
-            ]
-        ];
-
         return [
             'links' => [
                 '/downloadable-links',
-                'GetLinks',
+                'GetList',
                 $linkExpectation,
             ],
-            'samples' => [
-                '/downloadable-links/samples',
-                'GetSamples',
-                $sampleExpectation,
-            ],
         ];
     }
 }

dev/tests/api-functional/testsuite/Magento/Downloadable/Api/SampleRepositoryTest.php

@@ -515,4 +515,56 @@ public function testDeleteThrowsExceptionIfThereIsNoDownloadableSampleWithGivenI
 
         $this->_webApiCall($this->deleteServiceInfo, $requestData);
     }
+
+    /**
+     * @magentoApiDataFixture Magento/Downloadable/_files/product_downloadable_with_files.php
+     * @dataProvider getListForAbsentProductProvider
+     */
+    public function testGetList($urlTail, $method, $expectations)
+    {
+        $sku = 'downloadable-product';
+
+        $serviceInfo = [
+            'rest' => [
+                'resourcePath' => '/V1/products/' . $sku . $urlTail,
+                'httpMethod' => \Magento\Framework\Webapi\Rest\Request::HTTP_METHOD_GET,
+            ],
+            'soap' => [
+                'service' => 'downloadableSampleRepositoryV1',
+                'serviceVersion' => 'V1',
+                'operation' => 'downloadableSampleRepositoryV1' . $method,
+            ],
+        ];
+
+        $requestData = ['sku' => $sku];
+
+        $list = $this->_webApiCall($serviceInfo, $requestData);
+
+        $this->assertEquals(1, count($list));
+
+        $link = reset($list);
+        foreach ($expectations['fields'] as $index => $value) {
+            $this->assertEquals($value, $link[$index]);
+        }
+    }
+
+    public function getListForAbsentProductProvider()
+    {
+        $sampleExpectation = [
+            'fields' => [
+                'title' => 'Downloadable Product Sample Title',
+                'sort_order' => 0,
+                'sample_file' => '/f/u/jellyfish_1_4.jpg',
+                'sample_type' => 'file'
+            ]
+        ];
+
+        return [
+            'samples' => [
+                '/downloadable-links/samples',
+                'GetList',
+                $sampleExpectation,
+            ],
+        ];
+    }
 }