Сомнения в правильности Microsoft Azure Мультимедийные услуги REST API

Question

The Azure API claims to be a REST API. Я нашел его в то время как для моделей и реализации образцов и глаголов в REST, при проверке его in their (supposedly) REST API reference, они, кажется, придумали новый глагол CancelJob и изменяющие внутреннее состояние через HTTP GET

GET 
https://media.windows.net/API/CancelJob?jobid='URL-encodedvalue' 

Это, кажется, противоречит передовой практики, будет ли он реализован с ресурсом Jobs и DELETE, или это правильно сделать так?

DELETE 
/API/Jobs?jobid='URL-encodedvalue' 

Или даже?

DELETE 
/API/Jobs/jobid 

Answer 1

REST стал словом, которое люди используют для любого API, который работает через HTTP. Этот API, по-видимому, является тем, что некоторые люди называют REST уровнем 1. Уровень 1 означает, что вы используете HTTP только в качестве транспортного механизма. Он не учитывает любые ограничения REST, для которых предназначен HTTP. Я не думаю, что это справедливо, чтобы назвать эти API REST вообще, но многие по-прежнему делают, потому что REST является популярным и деловым/маркетинговым человеком, что можно сказать, что у них есть REST API. Я подозреваю, что так обстоит дело с этим API, потому что архитектор (ы) этого API явно не прилагает никаких усилий к следующим принципам REST.