benatespina / StackExchangeApiClient

     *

     * @return Answer

     */

    public function accept($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/accept', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Undoes an accept vote on the given answer.

     *

     * @return Answer

     */

    public function undoAccept($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/accept/undo', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Deletes an answer.

     *

     * @return Answer

     */

    public function delete($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->delete(

            self::URL . $id . '/delete', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Downvotes an answer.

     *

     * @return Answer

     */

    public function downvote($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/downvote', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Undoes an downvote on an answer.

     *

     * @return Answer

     */

    public function undoDownvote($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/downvote/undo', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Edit an existing answer.

     *

     * @return Answer

     */

    public function update($id, $body, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/edit', array_merge(['body' => $body], $params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Upvotes an answer.

     *

     * @return Answer

     */

    public function upvote($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/upvote', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Undoes an upvote on an answer.

     *

     * @return Answer

     */

    public function undoUpvote($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/upvote/undo', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Casts a flag against the answer identified by id.

     *

     * @return Answer

     */

    public function addFlag($id, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->put(

            self::URL . $id . '/flags/add', array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Gets the answers to a set of questions identified in id.

     *

     * @return Answer

     */

    public function addOfQuestionId($id, $body, array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->post(

            'questions/' . $id . '/' . self::URL . 'add', array_merge(

                ['body' => $body], $params, $this->authentication->toArray()

            )

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Render an answer given it's body and the question it's on.

     *

     * @return array|Answer

     */

    public function myAnswers(array $params = self::QUERY_PARAMS, $serialize = true)

    {

        if (!$this->authentication instanceof Authentication) {

            throw new \Exception('Authentication is required');

        }

        $response = HttpClient::instance()->get(

            'me/' . self::URL, array_merge($params, $this->authentication->toArray())

        );

        return $serialize === true ? AnswerSerializer::serialize($response) : $response;

    }

    /**

     * Returns the top 30 answers a user has posted in response to questions with the given tags.