README

Meetup（http://meetup.com）是一个基于社区团体的社交网站。Meetup提供API，允许远程应用程序访问其平台服务，以管理身份验证、事件、RSVP等。

到目前为止，还没有一个适用于Meetup API的好PHP客户端。该项目旨在通过提供一个高质量的独立Meetup API PHP客户端来填补这一空白。此客户端通过提供的类简单易用，还允许通过直接查询API进行强大的高级使用。

注意：此项目目前仅支持对Meetup API的GET请求。

支持的端点

/2/checkins /2/events /2/event /2/open_events /2/event_comments /2/event_ratings /activity /2/groups /comments /2/members /2/member /2/profiles /2/photo_comments /2/photo_albums /2/photos /2/rsvps /topics /2/open_venues /2/venues

文档

完整文档可以在Github项目的wiki上找到，网址为https://github.com/blobaugh/Meetup-API-client-for-PHP/wiki

如何设置库

• 从Github下载文件，并将它们放置在PHP应用程序目录中
• • 例如：/var/www/myapp/Meetup-API-client-for-PHP
• 在您的应用程序中包含Meetup.php文件
• • 例如：在/var/www/myapp/index.php中
• • 使用require_once('Meetup-API-client-for-PHP/Meetup.php');
• 使用您的Meetup API密钥连接到API，该密钥可在http://www.meetup.com/meetup_api/key/获取
• • $meetup_api_key = '';
• • $connection = new MeetupKeyAuthConnection($meetup_api_key);
• 开始在您的应用程序中使用新的Meetup功能！

使用预构建的端点类

PHP Meetup API客户端允许开发者直接调用Meetup API，但为了方便，已创建了几个辅助类。每个类直接对应于Meetup API文档中的端点分组。这些类接受与Meetup API文档中的参数相对应的关联数组。

示例：访问ID为14508967的Ben Lobaugh用户的所有Meetup活动。有关其他参数和响应格式，请参阅http://www.meetup.com/meetup_api/docs/2/events/

$m = new MeetupEvents($connection); $events = $m->getEvents(array('member_id' => '14508967'));

$events将以关联数组的形式出现

请参阅Meetup API文档了解每个端点使用的参数http://www.meetup.com/meetup_api/docs

直接查询Meetup API

PHP Meetup API客户端支持如果不可用辅助类的情况下直接API查询。查询发送到MeetupApiRequest类，从Meetup API接收的数据将在MeetupApiResponse类中返回。MeetupApiResponse对象将包含HTTP代码和API响应。要使用MeetupApiReponse类，开发者只需调用带有端点和参数的查询方法。

示例：访问ID为14508967的Ben Lobaugh用户的所有Meetup活动。有关其他参数和响应格式，请参阅http://www.meetup.com/meetup_api/docs/2/events/

$m = new MeetupApiRequest($connection); $events = $m->query(MEETUP_ENDPOINT_EVENTS, array('member_id' => '14508967'));

$events将是一个可以像数组一样访问的MeetupApiResponse对象（例如$events['results']）或用于遍历每个活动条目的循环（例如foreach($events AS $event)）。可以检查HTTP响应代码$events->getHttpCode()

异常

当收到无效的API请求时，通常会抛出异常。以下是所有Meetup API客户端针对PHP特定异常的列表：

• MeetupInvalidParametersException - 向API端点传递了无效或缺失的参数
• MeetupBadRequestException - 请求存在问题
• MeetupUnauthorizedRequestException - 无效的API密钥
• MeetupInternalServerErrorException - Meetup API服务器存在问题

开发路线图

• OAuth集成 - 高优先级
• POST支持
• 全球端点实现

如果您想看到具体的新的发展，请随时通过代码贡献或财务激励进行贡献。