[XRAY] add get_test_run_iteration method and add more meaningful error raising for incorrect token in XRAY (#1504)

* [XRAY] add get_test_run_iteration method

* [XRAY] added raise_for_status method - could solve #1059, #1159

* [XRAY] updated docs

---------

Co-authored-by: Maksym Charuta <your_jlr_email>