Date   

Re: Files access?

Dennis Parker
 

How far back does the yahoo storm set you on your roadmap? I am interested in using the API to upload files, but it is marked "don't use" right now. 

Can you estimate when you might have time to get to work of this kind? Weeks? Months? No pressure, just want to know if I need to think about doing my tasks a different way.

Thanks,

Dennis


Re: enable download_archives permission

valcos
 

The group's owner doesn't know how to enable the download_archives permission. Is there any documentation that explains how to do that?

Cheers,
Valerio


enable download_archives permission

valcos
 

Hi there,

How can I enable the download_archives permission to download archives from a group? Should I contact the group's owner or there are some steps I can do on my side?

Thanks in advance,
Valerio


Re: Files access?

 

On Sat, Sep 14, 2019 at 7:12 PM Matt Dorn <matt.dorn@...> wrote:
There doesn't appear to be an endpoint to access a group's file uploads.  Is this on the roadmap?  I'm still wading through the API reference documentation so I may be missing something.

It's on the road map. Probably in a week or two.

Thanks,
Mark 


Files access?

Matt Dorn
 

There doesn't appear to be an endpoint to access a group's file uploads.  Is this on the roadmap?  I'm still wading through the API reference documentation so I may be missing something.

Thanks,

Matt


Re: how to login using Facebook\Google?

 

On Tue, Aug 13, 2019 at 11:07 AM, Fred Nielsen wrote:

For accounts that leverage Facebook or Google Oauth, how should a login API call be transacted - or does the API not support this yet?

I have added new endpoints to log in via Facebook or Google using Oauth. Please see the API docs in the Login section.

Cheers,
Mark


BREAKING CHANGES #important

 

Hello,

There are some upcoming breaking changes to the API. 

The most important change is that we're switching from HTTP Basic Auth to a cookies based authentication. Starting now, the /login endpoint will set one or more cookies. The `token` field in the returned login object will be blank. Your existing Basic Auth tokens will continue to work until the end of September, or when they expire, whichever comes first.

Along with switching to a cookies based authentication system, we have added CSRF protection to all POST endpoints. When using the `login` endpoint, the User structure that's returned now includes a `csrf_token` field. Use that value for the `csrf` POST parameter now required by these endpoints. NOTE: During this transition period, if you use HTTP Basic Auth, the csrf POST value is not required, so your code should continue to work.

Finally, we are switching the domain of the API. It has been https://api.groups.io. It is moving to https://groups.io/api/. The old domain will continue to work until the end of September, but please update your code as soon as possible.

I apologize for this, but these changes are needed. The switch to a cookies-based authentication was to support chat; no Javascript websocket libraries support Basic Authentication or adding HTTP header fields. The other changes were a result of this as well.

Your code should continue to work as is until the end of September, but please update as soon as possible. Please let me know if you have any questions.

Thanks,
Mark


Re: how to login using Facebook\Google?

 

On Tue, Aug 13, 2019 at 11:07 AM Fred Nielsen <fredless@...> wrote:
For accounts that leverage Facebook or Google Oauth, how should a login API call be transacted - or does the API not support this yet?
_._,_._,_

The API doesn't yet support it, but that needs to happen soon as we continue development of the app. 

Thanks,
Mark


how to login using Facebook\Google?

Fred Nielsen <fredless@...>
 

For accounts that leverage Facebook or Google Oauth, how should a login API call be transacted - or does the API not support this yet?


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

 

On Tue, Aug 6, 2019 at 7:43 PM Timothy Fong <timfong888@...> wrote:
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. 

Which endpoint did you use to remove the member?

Thanks,
Mark 


sub_id renamed to member_info_id

 

Hi All,

To make things more clear, I have renamed all instances of the sub_id parameter to member_info_id. To maintain backwards compatibility, sub_id will still be supported, but it isn't mentioned in the docs, and going forward you should use member_info_id instead.

This affects calls in the Members and User sections of the API.

Please let me know if you have any questions.

Thanks,
Mark


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

Timothy Fong
 

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?

 

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

 

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

 

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?

 

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?

Timothy Fong
 

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

Timothy Fong
 

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

Timothy Fong
 

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