Re: [meetup-api] Where are the high level docs?

[Nathan Hamblen]

Hi Ron, it's true that the API could benefit from some higher level
documentation, the Everywhere methods particularly. Thanks for the feedback.

Nathan


On 09/19/2012 10:54 AM, ronman wrote:
> The API is straightforward. What I'm looking for is the documentation
> on the concepts, for example: What's the relationship between a
> Container and Communities? Does a container need multiple communities
> in order to have events in many different cities? What if you don't
> know what those cities will be? What's a Seed Event? What's a
> Concierge? etc., etc. --

[Nathan Hamblen]

On 09/25/2012 11:57 PM, Dominique wrote:

I completely agree, I'm having no problem dealing with the obvious objects in the API (event, member, etc.) but there is no documentation that I can see for those other objects that seem to have no relationship to the Meetup Web site.

I think the methods you're referring to have to do with Meetup Everywhere which does exist on the web site:
http://www.meetup.com/everywhere

However, it is a separate platform from the much larger Meetup Groups (or just "Meetup") with different concepts. At this time we are not building much on top of Everywhere, nor are we writing extensive documentation for it, but you are free to use the platform on the web site as well as its API, and we can answer specific questions about API methods.

Nathan

[*Dominique*]

Hi Nathan,

Thanks for the note! Unfortunately it doesn't seem to answer any of our questions. We've been asking about objects, specifically, the ones mentioned in the text pointed to by the link you included in your response such as Containers and Communities. It would be really great if we could get some description of these objects, just to hold us over until your documentation comes up to speed. :-)

And now you've opened another area of concern for me ;-)... if I'm looking at the "everywhere" API, what is this other platform, the "much larger API" of which you speak? Where is it's documentation? Should I instead be writing to that API since it's the one you say is documented and you're using?

Dominique

--
You received this message because you are subscribed to the Google
Groups "Meetup API" group.
To unsubscribe from this group, send email to
meetup-api+...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/meetup-api?hl=en?hl=en

[Nathan Hamblen]

On 09/26/2012 12:09 PM, *Dominique* wrote:
> Hi Nathan,
>
> Thanks for the note! Unfortunately it doesn't seem to answer any of our
> questions. We've been asking about objects, specifically, the ones
> mentioned in the text pointed to by the link you included in your
> response such as Containers and Communities. It would be really great if
> we could get some description of these objects, just to hold us over
> until your documentation comes up to speed. :-)

An everywhere container is, for example, this Mashable instance:
http://www.meetup.com/Mashable/

Within a container you have communities like this one for New York:
http://www.meetup.com/Mashable/New-York-NY/

And finally, an event within the community:
http://www.meetup.com/Mashable/New-York-NY/454852/

>
> And now you've opened another area of concern for me ;-)... if I'm
> looking at the "everywhere" API, what is this other platform, the "much
> larger API" of which you speak?

Meetup. For example, the New York Tech Meetup:
http://www.meetup.com/ny-tech

> Where is it's documentation?

Same place: http://www.meetup.com/meetup_api/

All methods that are not marked as "everywhere" methods are for the
Meetup (groups) API. All everywhere methods start with /ew in the path.

> Should I
> instead be writing to that API since it's the one you say is documented
> and you're using?

It depends whether you want to work with Meetup Groups or Meetup
Everywhere. The primary difference is that every Meetup group is founded
and run by an organizer, and groups are independent; there is nothing
like the global container that Everywhere has. Also, organizers pay dues
to use the platform:
http://www.meetup.com/help/Does-it-cost-money-to-start-a-Meetup-Group

If you have more questions, I think the next best step would be to
explain what you are trying to build.

Nathan