fuzz-introspector icon indicating copy to clipboard operation
fuzz-introspector copied to clipboard

web_api: Consider Semver

Open nathaniel-brough opened this issue 1 year ago • 0 comments

I'm not sure how stable the web api is going to be but would it make sense to semver it. e.g. Rather than;

curl -L https://introspector.oss-fuzz.com/api/far-reach-but-low-coverage?project=json-c

It'd be something like;

curl -L https://introspector.oss-fuzz.com/api/v1.0.0/far-reach-but-low-coverage?project=json-c

I'd be ok with only one version being supported at any one point and then if you use an old version you'd get back a deprecated response. Something like;

$ curl -L https://introspector.oss-fuzz.com/api/v0.9.0/far-reach-but-low-coverage?project=json-c
{
  "result": "API version v0.9.0 is deprecated, please use v1.0.0",
}

nathaniel-brough avatar Nov 24 '23 22:11 nathaniel-brough