PIM-1963 Improve product rest api

| Q                   | A
| ------------------- | ---
| Bug fix?            | N
| New feature?        | N
| BC breaks?          | Y
| Tests pass?         | Y
| Scenarios pass?     | Y
| Checkstyle issues?  | N
| Changelog updated?  | Y
| Fixed tickets       | PIM-1963
| Doc PR              |