README

这是Monscierge API的PHP包装器。创建一个应用程序以获取客户端凭证，以便通过API进行认证。

安装

只需将以下内容添加到您的composer.json require块中

'monscierge/php-sdk'

所有API方法都需要您使用已在Monscierge注册的客户端进行认证。然后，您将使用这些凭证来实例化您的客户端实例。

$client = new \Monscierge\Client($client_id, $client_secret);

您可以将客户端凭证交换为OAuth令牌，用于任何非用户认证的API。

$oauth_token = $client->clientCredentialsExchange('uber4cats', 'nom0res3crets');

对于需要用户权限来更改上下文的方法，您可以使用OAuth流程并将用户重定向到授权URL，当用户同意所需的权限后，将允许以用户身份访问。

$authorize_url = $client->authorizeUrl('http://example.app/monscierge/callback');

或者，您可以要求用户提供登录凭证以交换OAuth令牌，但这通常不推荐。

$oauth_token = $client->basicCredentialsExchange('johnny.appleseed@monscierge.com', '123456');

一旦您有了OAuth令牌，为了进行API调用，您应该在客户端实例上设置访问令牌。

$client->setAccessToken($oauth_token['access_token']);

您还希望存储refresh_token，以防止您的应用程序用户的会话超时。当令牌过期时，您可以将其交换为新的OAuth令牌以继续进行API调用。

$client->refreshTokenExchange($oauth_token['refresh_token']);

$client->places('San Francisco');

$client->userRequests();

有关更多示例，请深入了解SDK客户端并查看方法签名。如果您有任何问题或反馈，请创建问题或发送给我们电子邮件。