Deprecate lastCallFailed.

Author: icedream

docs/usage.md

@@ -199,6 +199,8 @@ $client->stopImpersonateUser();
 
 You can now use the `getApi()` method to create and get a specific Redmine API.
 
+To check for failed requests you can afterwards check the status code via `$client->getLastResponseStatusCode()`.
+
 ```php
 // ----------------------------
 // Trackers

src/Redmine/Api/AbstractApi.php

@@ -28,9 +28,14 @@ public function __construct(Client $client)
      * Returns whether or not the last api call failed.
      *
      * @return bool
+     *
+     * @deprecated This method does not correctly handle 2xx codes that are not 200 or 201, use \Redmine\Client\Client::getLastResponseStatusCode() instead
+     * @see Client::getLastResponseStatusCode() for checking the status code directly
      */
     public function lastCallFailed()
     {
+        @trigger_error('The '.__METHOD__.' method is deprecated, use '.Client::class.'::getLastResponseStatusCode() instead.', E_USER_DEPRECATED);
+
         $code = $this->client->getLastResponseStatusCode();
 
         return 200 !== $code && 201 !== $code;