Obter detalhes do pedido de serviço por ID

Artigo
05/28/2024

Aplica-se a: Partner Center | Partner Center for Microsoft Cloud for US Government

Como recuperar os detalhes de uma solicitação de atendimento ao cliente existente usando o identificador de solicitação de serviço.

Pré-requisitos

Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais App+User.
Um ID de solicitação de serviço.

C#

Para recuperar os detalhes de uma solicitação de atendimento ao cliente existente, chame o método IServiceRequestCollection.ById e passe um ServiceRequest.Id para identificar e retornar uma interface para o objeto ServiceRequest específico.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest as ServiceRequest;

ServiceRequest serviceRequestDetails = partnerOperations.ServiceRequests.ById(existingServiceRequest.Id).Get();

Console.WriteLine(string.Format("The primary contact for the service request {0} is {1} {2}.",
    serviceRequestDetails.Title,
    serviceRequestDetails.PrimaryContact.FirstName,
    serviceRequestDetails.PrimaryContact.LastName,
));

Pedido REST

Sintaxe da solicitação

Método	URI do pedido
GET	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

Parâmetro URI

Use o seguinte parâmetro URI para obter a solicitação de serviço especificada.

Name	Tipo	Obrigatório	Description
ServiceRequest-ID	string	Y	Um valor alfanumérico que identifica a solicitação de serviço.

Cabeçalhos do pedido

Name	Tipo	Obrigatório	Description
IncludeOrganizationRequests	string	N	Um cabeçalho que, quando presente, autorizará o usuário para a função de Administrador de Solicitação de Suporte antes de tentar obter detalhes da solicitação de serviço.

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhuma

Exemplo de solicitação

GET https://api.partnercenter.microsoft.com/v1/servicerequests/616122292874576 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f9a030bd-e492-4c1a-9c70-021f18234981
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 0

Resposta do REST

Se bem-sucedido, esse método retorna um recurso de solicitação de serviço no corpo da resposta.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 566
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f9a030bd-e492-4c1a-9c70-021f18234981
MS-CV: rjLONPum/Uq94UQA.0
MS-ServerId: 030011719
Date: Mon, 09 Jan 2017 23:31:15 GMT

{
    "title": "TrialSR",
    "description": "Ignore this SR",
    "severity": "critical",
    "supportTopicId": "32444671",
    "supportTopicName": "Cannot manage my profile",
    "id": "616122292874576",
    "status": "open",
    "organization": {
        "id": "3b33e682-00c3-41ee-9dd2-a548adf56438",
        "name": "TEST_TEST_BugBash1"
    },
    "productId": "15960",
    "createdDate": "2016-12-22T20:31:17.24Z",
    "lastModifiedDate": "2017-01-09T23:31:15.373Z",
    "lastClosedDate": "0001-01-01T00:00:00",
    "notes": [{
            "createdByName": "Account",
            "createdDate": "2017-01-09T23:31:15.373",
            "text": "Sample Note"
        }
    ],
    "attributes": {
        "objectType": "ServiceRequest"
    }
}

Partilhar via