Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

1. Consulta de Provedores Cadastrados

URL: /provedor

Método HTTP: GET

Descrição: Retorna uma lista de todos os provedores cadastrados.

Autenticação: Requer token JWT no cabeçalho Authorization.

Resposta de Sucesso: 200 OK

Exemplo de Corpo da Resposta:

[
    {
        "idProvedor": 1,
        "nome": "NOME_PROVEDOR",
        "tipo": "TIPO_PROVEDOR",
        "intervaloBusca": 1,
        "urls": [
            {
                "tipo": "TIPO_URL",
                "url": "URLPROVEDOR.COM.BR",
                "ambiente": "homolog"
            }
        ]
    },
    {
        "idProvedor": 2,
        "nome": "NOME_PROVEDOR_2",
        "tipo": "TIPO_PROVEDOR",
        "intervaloBusca": 1,
        "urls": [
            {
                "tipo": "TIPO_URL",
                "url": "URLPROVEDOR2.COM.BR",
                "ambiente": "homolog"
            }
        ]
    }
]

2. Consulta de Provedor por ID

URL: /provedor/{id}

Método HTTP: GET

Descrição: Retorna os detalhes de um provedor específico pelo seu ID.

Parâmetros:

id (Path Variable): ID do provedor a ser consultado.

Autenticação: Requer token JWT no cabeçalho Authorization.

Resposta de Sucesso: 200 OK

Exemplo de Corpo da Resposta:


{
    "idProvedor": 1,
    "nome": "NOME_PROVEDOR",
    "tipo": "TIPO_PROVEDOR",
    "intervaloBusca": 1,
    "urls": [
        {
            "tipo": "TIPO_URL",
            "url": "URLPROVEDOR.COM.BR",
            "ambiente": "homolog"
        }
    ]
}

3. Criar Novo Provedor

URL: /provedor

Método HTTP: POST

Descrição: Cria um novo provedor.

Parâmetros:

ProvedorDTO (Request Body): Dados do novo provedor.

...

{
    "nome": "NOME_PROVEDOR",
    "tipo": "TIPO_PROVEDOR",
    "intervaloBusca": 1,
    "urls": [
        {
            "tipo": "TIPO_URL",
            "url": "URLPROVEDOR.COM.BR",
            "ambiente": "homolog"
        }
    ]
}

Autenticação: Requer token JWT no cabeçalho Authorization.

Resposta de Sucesso: 200 OK

Exemplo de Corpo da Resposta:

{
    "idProvedor": 17,
    "nome": "NOME_PROVEDOR",
    "tipo": "TIPO_PROVEDOR",
    "intervaloBusca": 1,
    "urls": [
        {
            "tipo": "TIPO_URL",
            "url": "URLPROVEDOR.COM.BR",
            "ambiente": "homolog"
        }
    ]
}

4. Atualizar Dados de um Provedor

URL: /provedor/{id}

Método HTTP: PUT

Descrição: Atualiza os dados de um provedor existente.

Parâmetros:

id (Path Variable): ID do provedor a ser atualizado.

ProvedorDTO (Request Body): Dados atualizados do provedor.

{
    "nome": "NOME_PROVEDOR_ATUALIZADO",
    "tipo": "TIPO_PROVEDOR",
    "intervaloBusca": 1,
    "urls": [
        {
            "tipo": "TIPO_URL",
            "url": "URLPROVEDOR.COM.BR",
            "ambiente": "homolog"
        }
    ]
}

Autenticação: Requer token JWT no cabeçalho Authorization.

Resposta de Sucesso: 200 OK

Exemplo de Corpo da Resposta:

{
    "idProvedor": 1,
    "nome": "NOME_PROVEDOR_ATUALIZADO",
    "tipo": "TIPO_PROVEDOR",
    "intervaloBusca": 1,
    "urls": [
        {
            "tipo": "TIPO_URL",
            "url": "URLPROVEDOR.COM.BR",
            "ambiente": "homolog"
        }
    ]
}

...