Perguntas sobre 'api-design'

14
respostas

A solução deve ser tão genérica quanto possível ou tão específica quanto possível?

Digamos que eu tenha uma entidade que tenha o atributo "type". Pode haver mais de 20 tipos possíveis. Agora me pedem para implementar algo que permita alterar o tipo de A- > B, que é o único caso de uso. Então, devo implementar algo que...
30.11.2017 / 19:31
7
respostas

Como as buscas se encaixam em uma interface RESTful?

Ao projetar uma interface RESTful, a semântica dos tipos de solicitação é considerada vital para o design. GET - lista coleção ou recuperar elemento PUT - Substituir coleção ou elemento POST - Criar coleção ou elemento EXCLUIR...
21.03.2014 / 11:59
4
respostas

O que é uma camada Anticorrupção e como ela é usada?

Estou tentando descobrir o que a camada Anticorrupção realmente significa. Eu sei que é uma maneira de fazer a transição / trabalhar com código legado ou APIs ruins. O que eu não entendo é como funciona e o que faz dele uma separação clara da ca...
22.01.2013 / 17:14
14
respostas

design da API RESTful. O que devo retornar se não houver linhas?

Atualmente, estou codificando uma API para uma rede social com o Slim Framework. Minha pergunta é: Quais são as melhores práticas quando não há linhas para retornar na estrutura do json? Digamos que essa chamada / v1 / get / movies retorne...
29.05.2013 / 08:09
10
respostas

Qual deve ser o código de status http para o erro "Serviço indisponível em sua área"?

Nosso serviço está em 5 cidades agora. Se alguém tentar chamar nossa API de serviço de qualquer outra cidade, queremos lançar esse erro Service not available in your area . A questão é, qual é o código http apropriado para este erro? 50...
12.07.2018 / 14:46
6
respostas

Quão necessário é seguir práticas de programação defensivas para códigos que nunca serão disponibilizados publicamente?

Estou escrevendo uma implementação Java de um jogo de cartas, então criei um tipo especial de Coleção que estou chamando de Zona. Todos os métodos de modificação da Coleção do Java não são suportados, mas há um método na API de Zona, move(Zone,...
04.12.2013 / 20:14
11
respostas

Uma API REST deve retornar um 500 Internal Server Error para indicar que uma consulta faz referência a um objeto que não existe?

Estou trabalhando com uma API REST que reside em um servidor que manipula dados para vários dispositivos de IoT. Minha tarefa é consultar o servidor usando a API para coletar informações de desempenho específicas sobre esses dispositivos....
23.03.2018 / 17:31
7
respostas

Por que java.util.ArrayList permite adicionar nulo?

Gostaria de saber por que java.util.ArrayList permite adicionar null . Existe algum caso em que eu queira adicionar null a um ArrayList ? Estou fazendo esta pergunta porque em um projeto tivemos um bug em que alguns códigos estavam...
03.09.2012 / 16:30
5
respostas

Devo retornar um status HTTP 400 (Bad Request) se um parâmetro estiver sintaticamente correto, mas violar uma regra comercial?

Digamos que eu tenha um ponto de extremidade REST que use um inteiro como parâmetro: /makeWaffles?numberOfWaffles=3 Neste caso, quero que o número seja positivo porque não posso gerar um número negativo de waffles (e solicitar 0 waffles é...
24.08.2016 / 21:45
7
respostas

Como convencer meu chefe a usar o REST SOAP? [duplicado]

Precisamos criar uma API para o nosso sistema. Como convencer meu chefe de que o REST é uma opção melhor que o SOAP (ou XML-RPC)? Eu digo que o REST é ... mais fácil de implementar e manter não é muito novo para aprender - simples HTT...
08.08.2011 / 15:08