REST: Documentation for method-specific fields is not generated

[koodikindral]

When I try to add some fields for POST method, then they don't appear in documentation:

'zf-content-validation' => array(
    'AlbumService\\V1\\Rest\\Album\\Controller' => array(
        'POST' => 'AlbumService\\V1\\Rest\\Album\\NewAlbumValidator',
    ),
),
'input_filter_specs' => array(
    'AlbumService\\V1\\Rest\\Album\\NewAlbumValidator' => array(
        0 => array(
            'name' => 'name',
            'required' => true,
            'filters' => array(),
            'validators' => array(),
            'description' => 'Album name',
            'allow_empty' => false,
            'continue_if_empty' => false,
        ),
    ),
),

zf-apigility-documentation\src\ApiFactory.php seems to iterate only over the input_filter array, and it doesn't look POST, PUT and other custom validation elements:

    if (isset($this->config['zf-content-validation'][$serviceClassName]['input_filter'])) {
        $validatorName = $this->config['zf-content-validation'][$serviceClassName]['input_filter'];
        $fields = array();
        if (isset($this->config['input_filter_specs'][$validatorName])) {
            foreach ($this->config['input_filter_specs'][$validatorName] as $fieldData) {
                $fields[] = $field = new Field();
                $field->setName($fieldData['name']);
                if (isset($fieldData['description'])) {
                    $field->setDescription($fieldData['description']);
                }
                $field->setRequired($fieldData['required']);
            }
            $service->setFields($fields);
            $hasFields = true;
        }
    }

[koodikindral]

please see: 711f08d

[kevinpapst]

Good idea, I worked on something very similar. But I thought about having validation fields for the default API methods instead of the HTTP methods.
Its likely that you want different validators for fetch() and fetchAll() were both would use the GET fields.