Endpoint questions

[khoroshevskyi]

Hello,

I am implementing endpoints for the schema registry and have two questions/discussion points:

1. I noticed that the /schemas/{namespace} endpoint specification includes a latest_version query parameter. Does this mean that the user provides a version (e.g., 1.2.2), and I should return all schema records where the latest version is 1.2.2?
2. I couldn't find any information about the basic /schemas/ endpoint. What should it look like?

[ianfore]

Agree about the ambiguity.

My understanding/assumption was this was intended to explicitly say that one wanted whatever the latest version of what each schema was - but on closer look this is a parameter which would take a value.

Not sure what the use case for this parameter is. One is asking for lists of the schema available in a namespace. The latest version returned is informational.

If one wants to work with versions of schema then you would use some variant of
/schemas/{namespace}/{schema_name}/versions/{semantic_version}

The endpoint I saw last week in the PEP implementation supported

• /schemas/namespace2/bedmaker/versions/1.0.0
• /schemas/namespace2/bedmaker/versions/latest

The first seems to fit the current spec. The second does not - but one can see the value in it.

I like the approach that in the absence of asking for a specific version, the latest version is supplied. That would remove the need for /latest.

[nsheff]

I think the latest_version query parameter is an error.