Skip to main content

Cancelar Pacote

Este endpoint é utilizado para cancelar um pacote específico baseado em seus dados. Acessível apenas por usuários autorizados.

Método: PATCH

URI do Endpoint: https://apigw-uat.satelital.com.br/orbia-marketplace-hub/v1/package

Requisição e Tipos de Dados

Tipo de Conteúdo da Requisição: application/json

Parâmetro da Requisição:

AtributoTipoDescrição
idintCódigo único do pacote que deverá ser cancelado (obrigatório).

Respostas Possíveis

Códigos de Resposta e seus significados:

Status CodeDescrição
200Ok: Requisição bem-sucedida, código e status de cancelamento são retornados.
400Bad Request: Erro na requisição devido a um problema de validação dos dados.
401Unauthorized: Falta de autenticação para acessar o endpoint.
403Forbidden: Autenticação bem-sucedida, mas acesso ao recurso é negado.
500Internal Server Error: Erro genérico indicando uma falha no servidor ao processar a requisição.

Exemplo de Requisição:


{
"id": 1234
}

Exemplos de Respostas:

  • Sucesso (200):

{
"id": 0,
"cancelStatus": "string"
}

  • ERRO (400):
{
"statusCode": 400,
"message": "Erro de validação.",
"errors": {
"additionalProp1": ["Erro específico 1"],
"additionalProp2": ["Erro específico 2"],
"additionalProp3": ["Erro específico 3"]
}
}

Como Testar o Endpoint

Para testar este endpoint, siga os passos:

  1. Abra o Postman ou similar.

  2. Configure o método da requisição para PATCH e insira a URI completa do endpoint.

  3. No campo de parâmetros de cancelamento, adicione o id do pacote que deseja cancelar.

  4. Envie a requisição e observe a resposta.

Importante

Para um teste bem-sucedido, certifique-se de que você tem as credenciais corretas (se necessário) e que o corpo da requisição está corretamente formatado conforme o exemplo.

Este documento serve como um guia básico para entender e testar o endpoint específico. Ajuste as seções conforme necessário para se adequar ao seu ambiente de negócios e práticas de desenvolvimento.

Como acessar no portal do parceiro

Observação

Todas as informações exibidas neste fluxo são apenas para consulta e não podem ser alteradas diretamente no portal.

Saiba como acessar ao status e cancelar pacotes desde o Portal do Parceiro.

  1. Faça login no "Portal Parceiro".
  2. No menu, clique no botão "Pacotes" e, em seguida, selecione "Ver pacotes cadastrados".
  3. Na tela, você poderá visualizar uma lista detalhada dos pacotes cadastrados, adicione dados no campo de busca e clique em "Pesquisar", em esta tela consegue ver no campo "status" o status do pacote.

tela portal

  1. Clique na linha do pacote cadastrado e veja mais detalhes sobre o pacote.

tela portal

  1. Clique no butão cancelar pacote.