> > There are several ways we can expose this. > > 1. Separate endpoints > 2. Overridden methods > 3. Extra parameters on methods. > > I believe 1. is probably the most robust and least polluted > method. For > instance with 2. it could be difficult to distinguish some > methods and 3. > clutters the entire interface. > > So for instance we could have > > getDocument(String collection, String id) > > That returns a string in the simple interface and returns a struct > containing the necessary pieces of the compressed document in > the complex > interface. > > Is someone planning to propose an API design? >
Good idea (about the two interfaces with different endpoints). I agree with the reasoning leading to preferring the first option. Unless anyone has already starting working on such an API (Kurt?), I wouldn't mind giving it a try James
