title: Define API routes in ZF3 having more than one parameters
body: <p>I wanna create an API route in zend framework 3 that has two parameters. I have defined my routes as follows:</p>
  
  <pre><code>'api' =&gt; [
      'child_routes' =&gt; [
      /* api/users/&lt;id&gt; */
      'users' =&gt; [
          'type'    =&gt; Segment::class,
          'options' =&gt; [
              'route'       =&gt; '/users[/[:id]]',
              'constraints' =&gt; [
                  'id' =&gt; '[0-9]+',
              ],
              'defaults' =&gt; [
                  'controller' =&gt; Api\Controller\UserController::class,
              ],
          ],
          'may_terminate' =&gt; true,
          'child_routes' =&gt; [
              /* api/users/&lt;uid&gt;/documents/&lt;id&gt; */
              'documents' =&gt; [
                  'type'    =&gt; Segment::class,
                  'options' =&gt; [
                      'route'       =&gt; '/documents[/:id]',
                      'constraints' =&gt; [
                          'id'   =&gt; '[0-9]+',
                      ],
                      'defaults' =&gt; [
                          'controller' =&gt; Api\Controller\DocumentController::class,
                      ],
                  ],
              ],
          ]
      ]
  ]
  </code></pre>
  
  <p>The routes I expects to be supported are:</p>
  
  <pre><code>api/users
  api/users/&lt;user_id&gt;
  api/users/&lt;user_id&gt;/documents
  api/users/&lt;user_id&gt;/documents/&lt;document_id&gt;
  </code></pre>
  
  <p>Following above rules, when I send an HTTP Get to api/users//documents, it refers to method "get" in "DocumentsController.php", while it is expected to call method "getList". </p>
  
  <p>The question is how should I change my routes, and is my resource definition follows API design principals?   </p>