I've found the /v2/find to be the hardest part to understand in the REST API due to the interaction between the q, name and select parameters.
The question is, does select=private even need to exist? Since the JSON snap object have a private value, shouldn't all searches return private snaps if authorization is provided? The client can then filter the results if this is required.
Perhaps it would be simpler if select=refresh was replaced with /v2/find/refreshable - this and the above would get rid of the select parameter entirely.
I've found the /v2/find to be the hardest part to understand in the REST API due to the interaction between the q, name and select parameters.
The question is, does select=private even need to exist? Since the JSON snap object have a private value, shouldn't all searches return private snaps if authorization is provided? The client can then filter the results if this is required.
Perhaps it would be simpler if select=refresh was replaced with /v2/find/ refreshable - this and the above would get rid of the select parameter entirely.