Как выполнить пользовательский запрос с использованием VSO/VSTS Rest API?

Question

Я надеялся на некоторую помощь в выполнении пользовательского VSO-запроса с использованием REST API. Но мне сложно создавать URL-адрес. Я использую следующую документацию, чтобы построить то, что хочу.

https://www.visualstudio.com/en-us/integrate/api/wit/wiql

Моя проблема заключается в том, что я не знаю, как и где хранить его запрос самостоятельно.

HTTPS: // {экземпляр}/defaultcollection/[{Проект} /] _apis/остряк/wiql апи-версия = {версия}

Пример, приведенный был

https://fabrikam.visualstudio.com/DefaultCollection/Fabrikam-Fiber-Git/_apis/wit/wiql?api-version=1.0

? Но это не показывает, как и где хранить запрос.

Я смог выполнить тот же запрос, используя сохраненный запрос, однако результаты не возвращают столбцы, которые я установил в запросе в VSO.

Answer 1

Конечная точка останова для выполнения запроса - это метод POST и ожидает, что тело JSON будет содержать ключ query.

Таким образом, чтобы выполнить пользовательский запрос, вы выполните POST-вызов до https://{instance}/defaultcollection/[{project}/]_apis/wit/wiql?api-version={version} с заголовком content-type, установленным на application/json, и телом запроса в нижнем формате.

{ 
    "query": string 
} 

Пример:

POST https://fabrikam.visualstudio.com/DefaultCollection/Fabrikam-Fiber-Git/_apis/wit/wiql?api-version=1.0 
Content-Type: application/json 

тела:

{ 
    "query": "Select [System.WorkItemType],[System.Title],[System.State],[Microsoft.VSTS.Scheduling.Effort],[System.IterationPath] FROM WorkItemLinks WHERE Source.[System.WorkItemType] IN GROUP 'Microsoft.RequirementCategory' AND Target.[System.WorkItemType] IN GROUP 'Microsoft.RequirementCategory' AND Target.[System.State] IN ('New','Approved','Committed') AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward' ORDER BY [Microsoft.VSTS.Common.BacklogPriority] ASC,[System.Id] ASC MODE (Recursive, ReturnMatchingChildren)" 
}