Perguntas com a marcação «api-design»

Hoje tive uma discussão acalorada sobre nosso aplicativo MVC. Temos um site escrito em MVC ( ASP.NET ) e, geralmente, segue o padrão de fazer algo na exibição -> pressionar o controlador -> o controlador cria um modelo (chama um gerente que obtém os dados, cria o modelo no diretório …

322 mvc  asp.net-mvc  api-design 

Estou tentando descobrir o que realmente significa a camada anticorrupção. Eu sei que é uma maneira de fazer a transição / contornar código legado ou APIs incorretas. O que não entendo é como funciona e o que a torna uma separação limpa da camada indesejável. Eu fiz algumas pesquisas, mas …

151 design-patterns  api-design  legacy  bad-code 

Ao projetar uma interface RESTful, a semântica dos tipos de solicitação é considerada vital para o design. GET - Coleta de lista ou elemento de recuperação PUT - Substituir coleção ou elemento POST - Criar coleção ou elemento DELETE - Bem, erm, exclua coleção ou elemento No entanto, isso não …

137 design  rest  api-design  http-request 

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 permita alterações arbitrárias de tipo, desde …

124 programming-practices  api-design  requirements 

Digamos que eu tenho um ponto de extremidade REST que usa um número inteiro como parâmetro: /makeWaffles?numberOfWaffles=3 Nesse caso, quero que o número seja positivo, porque não posso fazer um número negativo de waffles (e solicitar 0 waffles é uma perda de tempo). Então, eu quero rejeitar qualquer solicitação que …

56 api-design  http 

Digamos que você esteja codificando uma função que recebe entrada de uma API externa MyAPI. Essa API externa MyAPIpossui um contrato que declara que retornará a stringou a number. É recomendado para proteger contra coisas como null, undefined, boolean, etc., mesmo que isso não faz parte da API de MyAPI? …

51 design  api  api-design  web-services  functions 

Nosso serviço está em 5 cidades no momento. 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 seria o código http apropriado para esse erro? 503 serviço indisponível 403: Proibido ou alguma outra …

51 api  api-design  http 

Atualmente, estou codificando uma API para uma rede social com o Slim Framework. Minha pergunta é: Quais são as práticas recomendadas quando não há linhas para retornar na estrutura json? Digamos que esta chamada / v1 / get / movies retorne 2 linhas dos nomes dos filmes da tabela: [ …

50 programming-practices  rest  api-design  json 

Atualmente, estou trabalhando em um projeto com uma organização da seguinte maneira: Cliente - Obtém dados do servidor principal via API REST. Servidor - solicita dados de vários outros servidores por meio de APIs de terceiros APIs de terceiros - serviços fora do meu controle que fornecem dados ao servidor …

49 design  rest  api-design  server 

Eu estava pensando sobre isso. Suponha que eu tenha um userrecurso com ide namecampos. Se eu quiser atualizar um campo, poderia fazer uma solicitação PATCH para o recurso como este PATCH /users/42 {"name": "john doe"} E então o aplicativo atualizará o nome do usuário 42. Mas por que, se eu …

48 rest  api-design  http  web-api 

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 do Java's Collection não são suportados, mas há um método na API da região move(Zone, Card), que move um cartão da região em …

45 java  programming-practices  data-structures  api-design 

Continuo ouvindo pessoas (Crockford em particular) dizendo que o DOM é uma API terrível, mas não justificando realmente essa afirmação. Além das inconsistências entre navegadores, quais são algumas das razões pelas quais o DOM é considerado tão ruim?

42 javascript  api  api-design  dom 

Eu me pergunto por que java.util.ArrayListpermite adicionar null. Existe algum caso em que eu gostaria de adicionar nulla um ArrayList? Estou fazendo essa pergunta porque, em um projeto, tivemos um bug em que algum código estava sendo adicionado nullao arquivo ArrayListe era difícil identificar onde estava o erro. Obviamente, um …

41 java  api-design  collections 

Digamos no meu aplicativo, alguns usuários nos dão seu sobrenome e outros não. Em uma resposta da API REST, qual corpo é preferido: Com um valor "nulo": {"firstName": "Bob", "lastName": null} Ou apenas uma chave ausente: {"firstName": "Bob"}

40 rest  api-design  json 

Estou trabalhando com uma API REST que reside em um servidor que lida com dados de vários dispositivos IoT. Minha tarefa é consultar o servidor usando a API para coletar informações de desempenho específicas sobre esses dispositivos. Em uma instância, obtenho uma lista de dispositivos disponíveis e seus identificadores correspondentes …

39 api-design  error-handling  http-response