Skip to content

Maak operationId verplicht #366

Open

Description

@dvh

operationId is bedoeld om tooling te helpen leesbare namen in code te gebruiken. Code generators verzinnen zonder operationId elk hun eigen gegenereerde namen voor classes, functies, types, etc, waardoor de code in sommige gevallen slecht leesbaar wordt. Arazzo gebruikt operationId om te verwijzen naar specifieke stappen in een workflow en om deze stappen te beschrijven in gerenderde output voor developers. Hoe die operationId er precies uit moet zien is een tweede en wordt deels besproken in #197, maar het verplicht stellen is al een stap vooruit in een tijd waarin code generators een steeds grotere rol gaan spelen. Het is overigens backwarss compatible want het raakt de API zelf verder niet, behalve als je opnieuw code gaat genereren (maar dan heb je ook nieuwe software).

Activity

  1. added
    Scope: KleinKleine wijzigingen met beperkte scope
    Status: In onderzoekTer voorbereiding van uitwerking is onderzoek nodig.
    Type: WijzigingInhoudelijke wijziging op een standaard
    Overleg: TO-APITe agenderen voor het Technisch Overleg API
    on Nov 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Overleg: TO-APITe agenderen voor het Technisch Overleg APIScope: KleinKleine wijzigingen met beperkte scopeStatus: In onderzoekTer voorbereiding van uitwerking is onderzoek nodig.Type: WijzigingInhoudelijke wijziging op een standaard

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions