1. api@beta.groups.io
   Date   
Re: How do I get permissions to remove a user?

timfong888@...
 

Hi, yes. Some part of docs need to be clearer. I wouldn’t have associated id of a member info object to be referred to as a sub_id. 

That said: I did in fact try to remove a member I added through the api and could not. And I could not figure out where the permission was set to prevent that. 

On Tue, Aug 6, 2019 at 9:47 AM Mark Fletcher <markf@corp.groups.io> wrote:
On Fri, Aug 2, 2019 at 10:44 AM <timfong888@...> wrote:
when I try to remove a user, I get an error which says I don't have the right permissions. I cannot find documentation for setting permissions. 

When removing a user, the documentation says to use the subscribe Id. However, the member object doesn't have subscriber ID as a field I can use as a key. 


Every object has an `id` field, which is a number unique to that type of object. The `sub_id` parameter is referring to an `id` of a member_info object, which corresponds to a subscription. Would it make it more clear if I changed the name of that parameter from `sub_id` to something like `member_info_id`?

Thanks,
Mark

--

Inline image

Tim Fong
 
p: 415-508-6888

e: timfong888@...

 
 
Re: How do I get permissions to remove a user?

Mark Fletcher
 

On Fri, Aug 2, 2019 at 10:44 AM <timfong888@...> wrote:
when I try to remove a user, I get an error which says I don't have the right permissions. I cannot find documentation for setting permissions. 

When removing a user, the documentation says to use the subscribe Id. However, the member object doesn't have subscriber ID as a field I can use as a key. 


Every object has an `id` field, which is a number unique to that type of object. The `sub_id` parameter is referring to an `id` of a member_info object, which corresponds to a subscription. Would it make it more clear if I changed the name of that parameter from `sub_id` to something like `member_info_id`?

Thanks,
Mark
/login changes

Mark Fletcher
 

Hello,

The following changes have been made to the /login endpoint:

- It no longer requires an API_KEY.
- It has been changed from GET to POST. This is not yet enforced, but will be at some point. Please change your code if it's doing a GET to that endpoint to instead do a POST.

Thanks,
Mark
Re: Doc improvements

Mark Fletcher
 

On Mon, Jul 29, 2019 at 2:23 PM Bumble <pastorbumble@...> wrote:

Where can I find the API doc?  I am looking for a way to automate the adds into the appropriate subgroups when people signup to my organization through a web form. 

The API is at https://groups.io/api

Cheers,
Mark 
Re: How do I get permissions to remove a user?

Mark Fletcher
 

Tim,

I’m on vacation right now. I will answer your questions on Monday.

Thanks,
Mark

On Fri, Aug 2, 2019 at 7:44 PM <timfong888@...> wrote:
when I try to remove a user, I get an error which says I don't have the right permissions. I cannot find documentation for setting permissions. 

When removing a user, the documentation says to use the subscribe Id. However, the member object doesn't have subscriber ID as a field I can use as a key. 
How do I get permissions to remove a user?

timfong888@...
 

when I try to remove a user, I get an error which says I don't have the right permissions. I cannot find documentation for setting permissions. 

When removing a user, the documentation says to use the subscribe Id. However, the member object doesn't have subscriber ID as a field I can use as a key. 
Re: Using the API -- unclear documentation re: API KEY

timfong888@...
 

I saw in an old post to use as a key 123456.  It seemed to generate the token.

Does this mean the API is still in alpha?
Using the API -- unclear documentation re: API KEY

timfong888@...
 

From the authentication page:
Only the username field is used to provide information for authentication - for the login call, set it to your API key. The response will contain an API token which should be used as the username in all future requests until it expires.

Where is the API key?

From the login page:
curl "https://api.groups.io/v1/login?email=test@...&password=123456" \
-u API_KEY:

Substituting email and password, I get an error:  

{"object":"error","type":"api_key","extra":""}

I remove the extra :, and I get:
Enter host password for user 'API_KEY':
I enter my password (same as in query param) (note: none of this is expected based on the documentation), and I get....
{"object":"error","type":"api_key","extra":""}

Which of the following is true so we can get this done today (I wrote earlier today and haven't heard so this may be a repeat):

1) The example is incorrect (I cut and paste and it doesn't work, so what I cut and paste is wrong)
2) The API KEY is available, and is passed in as part of -u API_KEY:{MY_API_KEY}
3).....???
Re: Doc improvements

Bumble
 

Hi Mark,

Where can I find the API doc?  I am looking for a way to automate the adds into the appropriate subgroups when people signup to my organization through a web form. 

For example, my website will have a form to signup for Sports League. Then depends on what checkboxes people indicated, I would like to automate the subscriptions into the subgroups of Basketball, Volleyball, Soccer, etc.

Thanks,

-Bumble
/getsubgroups change

Mark Fletcher
 

Hi All,

Previously, /getsubgroups would return group aliases in addition to normal subgroups. I've changed it so that it no longer returns group aliases. There is a new endpoint, getgroupaliases that returns the aliases for a given group.

Also, I have changed /directadd so that if you specify a group alias as a subgroup, it no longer generates an error, but instead does the right thing and uses the group the alias points to.

Thanks,
Mark
Doc improvements

Mark Fletcher
 

Hi All,

I just pushed several improvements to the API docs. Much better expand/collapse behavior in the sidebar, and the sidebar is separately scrollable now. Also, long example responses are in fixed height scrollable windows. I've also made various other smaller tweaks. Hopefully it should be easier to navigate and find what you need now.

Thanks,
Mark
Re: Unparseable JSON http response on updategroup invalid_value

Mark Fletcher
 

Hi Eric,

On Fri, May 17, 2019 at 3:21 PM Eric Searcy <eric@...> wrote:
/updategroup is returning both an error object and group object separated by a newline when I get an invalid_value error, which means the http response can't be parsed as json (without first parsing/splitting newlines. Is this intentional, or is there a missing return statement somewhere?

In my case, I had accidentally passed "polls_access=group_access_none" (which is the "disable" value the other features use, but polls uses "polls_access_none").

Thanks for the bug report. It was a missing return statement. It's been fixed.

Mark 
Unparseable JSON http response on updategroup invalid_value

Eric Searcy
 

/updategroup is returning both an error object and group object separated by a newline when I get an invalid_value error, which means the http response can't be parsed as json (without first parsing/splitting newlines. Is this intentional, or is there a missing return statement somewhere?

In my case, I had accidentally passed "polls_access=group_access_none" (which is the "disable" value the other features use, but polls uses "polls_access_none").

The output was:

{"object":"error","type":"invalid_value","extra":"polls_access"}\n
{"id":####,"object":"group","created":"2019-05-16T18:30:43.092324171-07:00","updated":"2019-05-16T18:30:43.092324171-07:00","title":"","name":[... and so on]}\n

(I've added the literal \n's for clarity)

Regards,

Eric
Re: API for database access

Mark Fletcher
 

On Wed, May 1, 2019 at 8:59 PM Andrew Theaker <andrew@...> wrote:
Hi Mark, thanks for the quick reply. Is it the same for Events?
_._,_._,_
Right now, yes.

Thanks,
Mark 
Re: API for database access

Andrew Theaker <andrew@...>
 

Hi Mark, thanks for the quick reply. Is it the same for Events?
Re: API for database access

Mark Fletcher
 

On Mon, Apr 29, 2019 at 4:32 PM Andrew Theaker <andrew@...> wrote:

The document is not really clear on access to a groups databases. We have a catalogue of all board games we own. It would be great if I could access this via API and render it in a nice view. I was thinking we could also create a database to tracking our results from events (wins/losses/attendance etc) and extract this information for compiling stats in graphs etc. Ideally I'd like to implement these things through a javascript front-end and just query the API as required.

Currently there is no API access to a group's databases. That is on the TODO list, but I don't have a timeframe for when it will happen.

Thanks,
Mark 
Re: "type" query param of /v1/getmembers non-functioning?

Mark Fletcher
 

Hi Eric,

On Mon, Apr 29, 2019 at 5:38 PM Eric Searcy <eric@...> wrote:
The "type" of https://groups.io/api#get_members doesn't seem to do anything.

Thanks for the bug report. It should be fixed now.

Mark 
"type" query param of /v1/getmembers non-functioning?

Eric Searcy
 

The "type" of https://groups.io/api#get_members doesn't seem to do anything.

I was hoping to use &type=mods (and then further filter to just see
owners) but I got the entire list membership.

Then I tried type=pending and got the same thing.

Is this a bug, a doc issue, or am I doing something wrong?

-Eric

?
signature.asc

API for database access

Andrew Theaker <andrew@...>
 

Hi,

We are currently thinking about upgrading our group to premium and I'm trying to understand what benefits we could get from the API access.

The document is not really clear on access to a groups databases. We have a catalogue of all board games we own. It would be great if I could access this via API and render it in a nice view. I was thinking we could also create a database to tracking our results from events (wins/losses/attendance etc) and extract this information for compiling stats in graphs etc. Ideally I'd like to implement these things through a javascript front-end and just query the API as required.

Would these be possible with the current version of the API?
Re: Issue with /v1/updatesub

Eric Searcy
 

Thanks! (confirmed on my end, too :-) )

-Eric

On 4/25/19 9:30 AM, Mark Fletcher wrote:
Hi Eric,

It should now accept sub_id. If group_id is passed in as well, it will
be ignored.

Thanks,
Mark

On Thu, Apr 25, 2019 at 8:56 AM Eric Searcy <eric@linuxfoundation.org
<mailto:eric@linuxfoundation.org>> wrote:

Hi,

I'm calling updatesub as described in the documentation, and I'm
getting an error.

curl -v -u $GROUPIO_TOKEN: -d sub_id=##### -d sub_notify=sub_notify_none

=> {"object":"error","type":"bad_request","extra":"group_id"}

(Where ##### is the returned "id" field of the membership info
object when I ran /v1/getsub against a group_id I'm subscribed to.)

I can work around the error by adding group_id to the request. 
Subscriptions seem to be globally unique identifiers, so the way the
API documents it seems like it should work.

Two questions:

1) Can either the docs be updated, or the API be changed to match
the docs?

2) If you change the API to match the docs, can you ensure that any
passed group_id is just ignored (so it doesn't break backwards
compatibility).

Thanks!

-Eric

?
signature.asc

121 - 140 of 230