Sylius/adr/2021_06_15_api_platform_config_customization.md

API - Customization

• Status: accepted
• Date: 2021-06-15

Context and Problem Statement

Its difficult to overwrite or remove endpoints.

Considered Options

Overwriting resource configs

For now, the only way to customize API resources is by overwriting the entire configuration associated with the endpoint.

• Bad, because its not easy to configure.
• Bad, because it requires to change many files in end application.
• Bad, because any changes in the new Sylius version will not be applicable to overwritten configs

Config merging

To configure endpoint specify mapping file in config.

mapping:
    paths: ['%kernel.project_dir%/config/api_platform']

in specified directory all we need to do is create config we want to overwrite, for example:

'%sylius.model.zone.class%':
    collectionOperations:
        admin_get (unset): ~

This is example config to remove specific operation, more examples can be found in docs.

• Good, because its easy to understand, you can overwrite any endpoint in just a few lines from any place specified in api platform config.
• Bad, because we need to overwrite and modify services provided by API Platform, differences between API Platform versions can break our application.

Decision Outcome

Chosen option: "Config merging", because it allows us easily overwrite any endpoint, without getting deep into api platform resources.