Flag to establish user is team captain in list of teams

[molebhai]

Hi,
I was wondering if it would be possible to expose a flag that
establishes the user as a team captain in the following request,
GET /lenders/:lender_id/teams : http://api.kivaws.org/v1/lenders/jeremy/teams.html

or perhaps in the team members list request:
GET /teams/:id/lenders : http://api.kivaws.org/v1/teams/2/loans.html

a simple additional column "is_captain" with possible values 0 or 1
would satisfy both requests.

I'm building an app that makes use of the team features of Kiva, and
hopes to enhance the usefulness of teams. I believe this app will
greatly help with spreading knowledge of kiva while also aid in
getting more loans to a fully funded state. But its important that I
be able to establish a user as team captain.

I'm not sure if exposing this information is going too far as per a
users terms of agreement. I personally don't see a downside, but you
guys would know better.

Thanks a lot.
Amol

[Skylar Woodward]

Amol,

That's a great idea. We currently make captainship public so that
should be easy to do (unless the captain is Anonymous, which would be
rare). Perhaps we could have

GET /teams/:id/captains

as a method. This would make it easy to find and identify the captain
(s) even if there are thousands of lenders on a team. Let us know
what you think.

skylar

[molebhai]

Hey Skylar,
I was really hoping to get the additional column in the
GET /lenders/:lender_id/teams
result set.

my app starts by asking the user their lender_id and then fetches
which teams they belong too. I then need to establish which teams (if
any at all) that user captains.
Having that extra flag in the lender_id/teams request would save N
extra requests ( N = number of teams user belongs too) and a lot of
coding on my side.
But having thought about it a little more I realize adding another
field to an existing data set could possibly create problems with
other developers applications.

perhaps on top of method you suggested we could have another method
GET /lenders/:lender_id/teams_iscap/
which would return only the teams that user captains.

I'm definitely for /teams/:id/captains method though. I'm pretty
sure I would make use of that somewhere in my app.

Amol