$data = $nylas->Authentication->Hosted->sendAuthorizationCode($params);

// save your token some where
// or update the client option
$nylas->Options->setAccessToken("pass the token you got");

1. common error codes that response from nylas are wrapped as exceptions, (see src/Exceptions) and the exception code is the same as nylas api error list

2. you will get an array like below, when response data was not a valid json string or even not json content type:

   [
       'httpStatus'  => 'http status code',
       'invalidJson' => true,
       'contentType' => 'response header content type',
       'contentBody' => 'response body content',
   ]

3. for all methods that execute as the async mode will not throw an exception when an error occurs, instead, it will return an array which contains all data and exceptions inside like below:

   [
       // ...
       [
           'error'     => true,
           'code'      => 'exception code',
           'message'   => 'exception message',
           'exception' => 'exception instance',
       ],
       // ...
   ]

4. some email provider may not support all features, exp: calendar, event. for that reason you may get an exception named BadRequestException with 400 code and the msg:

   Malformed or missing a required parameter, or your email provider not support this.

5. the log_file parameter only works when debug set to true, then the detailed info of the http request will be logged.

   Tips: nylas-php use the guzzlehttp for http request. but guzzlehttp only support a resource type as the debug handler (cURL CURLOPT_STDERR required that).

   for anyone who wants to use psr/log interface to debug, you can init a temp resource, and pass the handler to nylas-php, then get log content from temp resource after calling some methods.

   $handler = fopen('php://temp', 'w+');
   
   $options =
   [
       'log_file' => $handler,
       ...
   ];
   
   $nylas = new Client($options);
   $nylas->doSomething();
   ....
   
   rewind($handler);
   $logContent = stream_get_contents($handler);
   fclose($handler);
   
   $yourPsrLogger->debug($logContent);

1. Initialise composer dependency composer install
2. Add your info in tests/AbsCase.php
3. Launch the test with composer run-script test
4. Another way to run tests: ./tests/do.sh foo.php --filter fooMethod, see tests/do.sh

Each method's comment has a link to their specific API document, see here

The parameters that required by methods almost the same as nylas official api required.

For more detail, you can view the tests or the source code of validation rules for that method.

$nylas->Management->Account->xxx();
$nylas->Management->Application->xxx();