diff --git a/src/Authentication.php b/src/Authentication.php index b50366f..0fe0cb3 100644 --- a/src/Authentication.php +++ b/src/Authentication.php @@ -5,18 +5,21 @@ use Psr\Http\Message\RequestInterface; /** - * Authenticate a PSR-7 Request. + * Add authentication information to a PSR-7 Request. * * @author Márk Sági-Kazár */ interface Authentication { /** - * Authenticates a request. + * Alter the request to add the authentication credentials. * - * @param RequestInterface $request + * To do that, the implementation might use pre-stored credentials or do + * separate HTTP requests to obtain a valid token. * - * @return RequestInterface + * @param RequestInterface $request The request without authentication information + * + * @return RequestInterface The request with added authentication information */ public function authenticate(RequestInterface $request); }