tator
tator copied to clipboard
LocalizationList and StateList endpoints can be confusing with inherited layers
If layers derive off of one another, it is currently expected that client side code explicitly asks for all layers in a GET request to LocalizationList or StateList.
1.) Evaluate whether this makes sense or if derived layers should be automatically appended. Then a.) Document endpoint with an example showing fetching a versioned layer so the explicit nature of the fetch is obvious. or, b.) Document how to fetch just a single layer if that is what you are after if the implemented behavior is changed (e.g. only specified layer flag)
Localizations
and States
endpoints should include a base_layers
parameter that enables server-side lookup and return of parent versions. This would spare us from doing recursive version object inspection without breaking backward compatibility.