search

openalto / alto

Standard Application-Layer Traffic Optimization (ALTO) Toolset.
MIT License
2 stars 6 forks source link

northbound API definition in OpenAPI specification is out of dated. #45

Closed itaru2622 closed 1 year ago

itaru2622 commented 1 year ago

current northbound API provided by src/alto/server/northbound/* has more interfaces and different than openalto/alto-swagger repo.

It's better to provide/generate openapi spec of northbound API in code-first manner from src/alto/server/northbound/*.

fno2010 commented 1 year ago

Nice proposal. Actually, the openalto/alto-swagger repo is quite old. When it was created 6 years ago, OpenAPI 3.0 was still not very mature. The patternProperties feature was not supported by most of the code generators. But many ALTO services highly rely on this feature.

I see the latest code generator may support patternProperties better. We can try to see if it is possible to integrate OpenAPI into openalto.

fno2010 commented 1 year ago

Personally, I feel the openalto/alto-jsonschema repo may be more useful than openalto/alto-swagger.