Resposta do servidor e tipos de dados

A Resposta que vem do servidor funciona quase de acordo com o mesmo esquema que o Request. Por razões óbvias, não tem parâmetros de pedido, mas os Cabeçalhos e o Corpo estão incluídos na resposta (embora possam estar vazios).

Uma diferença importante é o estado da resposta.

Códigos de estado

Código de estado. Vem na primeira linha da resposta do servidor. O estado é um número de três dígitos (o próprio código), seguido por uma frase que o explica.

É pelo código de estado que se pode saber sobre os resultados do pedido e compreender que acções devem ser tomadas a seguir.

Todos os códigos de estado possíveis estão divididos em 5 classes. O primeiro dígito do código determina a pertença a uma determinada classe. Vamos decompô-los.

1xx - códigos de informação. Relatar o progresso do pedido. Na prática real, eles são raramente utilizados.

2xx - códigos de sucesso. Informam que tudo está em ordem e que o pedido foi concluído com sucesso. Em resposta a um pedido de GET, esperamos normalmente receber um código de 200 (OK). Um pedido PUT bem sucedido envia um código 201 (Created).

3xx - redirecciona. Indicar que o pedido deve ser enviado para um endereço diferente. Um exemplo é o código 301 (Movido Permanentemente), indicando que os dados requeridos estão agora num novo endereço (o novo endereço em si é passado no cabeçalho Localização).

4xx - códigos de erro do cliente. O mais famoso deles - 404 (Não Encontrado), informa que não há dados necessários no endereço especificado. Outros casos comuns: 400 (Mau pedido, erro de sintaxe no pedido), 401 (Não autorizado, autenticação necessária para acesso), 403 (Proibido, acesso negado).

5xx - códigos de erro do servidor. Reportar um erro no lado do servidor. A título de exemplo: 500 (Internal Server Error, qualquer erro incompreensível que não possa ser atribuído ao código conhecido), 503 (Serviço Indisponível, o servidor é temporariamente incapaz de processar o pedido por razões técnicas)

Tipos de dados

Neste ponto, podemos assumir que lidámos com as informações básicas para compreender o REST API e a estrutura dos pedidos e respostas HTTP. Resta esclarecer apenas um ponto - tipos de dados. Se já tentou criar o seu pedido de API no AppMaster, provavelmente reparou que todos os dados (em parâmetros, em cabeçalhos, em corpo) lhe pedem para especificar não só o nome, mas também o tipo de dados.

É geralmente bastante óbvio para um humano como trabalhar com os dados, pois existe um certo contexto. Suponhamos que sabemos que 2 + 2 = 4. Supomos que estes são números e que o resultado da adição será outro número.

Mas podem não ser números, mas sim dados textuais. Então o resultado da sua adição poderia ser a concatenação de cordas e 2 + 2 transformar-se-ia em "22". Aqui, para que o computador não tenha de pensar em nada, há uma indicação exacta do tipo de dados. E, ao mesmo tempo, outras tarefas estão a ser resolvidas. Por exemplo, é fornecida protecção contra a introdução de dados incorrectos; inicialmente, não há oportunidade de registar um endereço de correio electrónico no campo destinado à introdução de números de telefone.

Existem muitos tipos de dados diferentes, agora vamos considerar os mais básicos, e em outros módulos do curso vamos familiarizar-nos com o resto.

String - Tipo de dados String, texto simples, sem formatação especial.

Inteiro - Tipo de dados Inteiro. Pode ser utilizado para contadores ou cálculos em que não são necessários números fracionários.

Flutuador - Número de ponto flutuante. É utilizado onde é necessária maior precisão e os valores inteiros não são suficientes.

Uma questão lógica pode surgir aqui. E porque não usar sempre Float, porque precisamos então do Integer? Mas uma maior precisão requer mais recursos. Para alguns cálculos pequenos isto pode ser completamente invisível, mas no caso de grandes quantidades de dados, a utilização de um tipo de dados razoável pode reduzir significativamente os requisitos de potência de computação e espaço em disco.

Booleano - tipo de dados booleanos. O tipo de dados mais simples. É necessário um de dois valores, que são escritos como Verdadeiro ou Falso. A designação pode muitas vezes ser vista sob a forma de 1 (verdadeiro) e 0 (falso).