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 próprio...

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 não...

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...

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 que sejam...

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...

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...

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...

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: [ {"name":...

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...

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...

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 questão para...

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

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...

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":

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...

Temos uma função de API que divide um valor total em valores mensais com base nas datas de início e término. // JavaScript function convertToMonths(timePeriod) { // ... returns the given time period converted to months } function getPaymentBreakdown(total, startDate, endDate) { const numMonths...

Estou propondo alterações em um projeto de software muito mal arquitetado que sofre de uma infinidade de problemas. Em um nível alto, o projeto utiliza Angular no front-end e consome várias APIs REST; o que é ótimo (não vejo a necessidade de mudar nossa tecnologia ou ferramentas). O problema é que...

Quando se trata de APIs JSON, é uma boa prática achatar respostas e evitar objetos JSON aninhados? Como exemplo, digamos que temos uma API semelhante à IMDb, mas para videogames. Existem algumas entidades, Game, Platform, ESRBRating e GamePlatformMap, que mapeiam Jogos e Plataformas. Digamos que...

Existe algum tipo de padrão em relação às respostas da API HTTP? Depois de ler este tópico do discurso , comecei a me perguntar. Estamos desenvolvendo nossa API HTTP JSON pública no meu trabalho e não retornamos nada quando não é estritamente necessário (por exemplo, um PUT para / resource / {id}...

Em uma discussão sobre métodos estáticos e de instância, eu sempre penso que Sqrt()deveria ser um método de instância de tipos numéricos em vez de um método estático. Por que é que? Obviamente, funciona com um valor. // looks wrong to me var y = Math.Sqrt(x); // looks better to me var y =...