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

Neste artigo, o autor afirma que Às vezes, é necessário expor uma operação na API que inerentemente não seja RESTful. e essa Se uma API tiver muitas ações, isso indica que ela foi projetada com um ponto de vista RPC em vez de usar os princípios RESTful ou que a …

24 rest  domain-driven-design  api-design  cqrs 

Supondo que um sistema em que haja um aplicativo Web com um recurso e uma referência a um aplicativo remoto com outro recurso semelhante, como você representa uma ação de sincronização bidirecional que sincroniza o recurso 'local' com o recurso 'remoto'? Exemplo: Eu tenho uma API que representa uma lista …

23 api  rest  api-design  synchronization 

Estou projetando uma API REST pragmática e estou um pouco preocupado com a melhor forma de adicionar entidades existentes a uma coleção. Meu modelo de domínio inclui um projeto que possui uma coleção de sites. Esse é um relacionamento estrito de muitos para muitos e não preciso criar uma entidade …

23 rest  api-design 

Estou construindo uma API, uma função que carrega um arquivo. Esta função não retornará nada / nulo se o arquivo tiver sido carregado corretamente e lança uma exceção quando houver algum problema. Por que uma exceção e não apenas falsa? Como dentro de uma exceção, posso especificar o motivo da …

22 java  api-design  exceptions  functions  architectural-patterns 

Recentemente, desenvolvi minha própria API e, com esse interesse investido em design de API, fiquei muito interessado em saber como posso melhorar meu design de API. Um aspecto que surgiu algumas vezes é (não pelos usuários da minha API, mas na minha observação de discussão sobre o tópico): deve-se saber …

20 programming-practices  naming  api  api-design 

Em um livro do sistema operacional, acabei de ler: "APIs públicas são para sempre: apenas uma chance de acertar". É verdade? É aplicável apenas em APIs de sistemas operacionais ou em outras APIs também? Por exemplo, isso será verdade para as APIs de aplicativos Android, como Tasker, Locale e Pushover?

20 android  api  api-design 

Fechado . Esta questão é baseada em opiniões . No momento, não está aceitando respostas. Deseja melhorar esta pergunta? Atualize a pergunta para que ela possa ser respondida com fatos e citações editando esta postagem . Fechado há 5 anos . Isto é para coleções ordenadas, por exemplo, java.util.List. Por …

19 java  api-design 

Depois de ser exposto a várias camadas de abstração de banco de dados, estou começando a me perguntar qual é o sentido de toda biblioteca inventar seu próprio paradigma diferente para acessar dados. Escolher um novo DAL é como aprender um novo idioma novamente, quando geralmente tudo o que eu …

18 database  sql  api-design  dsl 

Estamos desenvolvendo uma API Rest para site de comércio eletrônico, que será consumida por aplicativos móveis. Na página inicial de um aplicativo, precisamos chamar vários recursos, como Sliders, Marcas Principais, Produtos Mais Vendidos, Produtos em Tendência etc. Duas opções para fazer chamadas de API: Chamada única: www.example.com/api/GetAllInHome Várias chamadas: www.example.com/api/GetSliders …

18 rest  api  api-design  url 

Por que os designers de Java não criaram versões estáticas dos métodos de manipulação de string na java.lang.Stringclasse? Os métodos a seguir são os que me refiro, mas a pergunta também pode ser estendida a outros métodos não estáticos da classe. concat(String) substring(int, int) replace(char, char) toLowerCase() replace(CharSequence, CharSequence) toLowerCase(Locale) …

17 java  api-design  null 

Acabei de ler um artigo interessante chamado Ficando muito fofo com retorno de rendimento em c # Isso me fez pensar qual é a melhor maneira de detectar se um IEnumerable é uma coleção enumerável real ou se é uma máquina de estado gerada com a palavra-chave yield. Por exemplo, …

17 c#  api-design 

Estou usando uma biblioteca interna que foi projetada para imitar uma biblioteca C ++ proposta e, em algum momento nos últimos anos, vejo sua interface alterada de usar std::stringpara string_view. Então, eu mudo obedientemente meu código, de acordo com a nova interface. Infelizmente, o que eu tenho que passar é …

16 c++  api-design  strings 

Eu tenho dois recursos: usuários e links. Os usuários podem ter vários links associados a eles. Eu projetei minha API RESTful para que você possa acessar os links associados a um usuário no seguinte URI: /users/:id/links No entanto, eu sempre preciso ter um URI apenas para links - às vezes …

16 api  rest  api-design 

É muito comum especificar a versão das APIs REST no URL, especificamente no início do caminho, ou seja, algo como: POST /api/v1/accounts GET /api/v1/accounts/details No entanto, não vi nenhum design em que a versão esteja associada a cada API. Em outras palavras, mantemos a versão de cada API separadamente. ou …

15 rest  api-design  versioning  enterprise-architecture  engineering 

Estamos projetando uma API RESTful que se destina principalmente a atender às necessidades de um único cliente. Por causa de suas circunstâncias muito particulares, esse cliente precisa fazer o menor número possível de solicitações. A API manipula o i18n por meio de um cabeçalho Accept-Language nas solicitações. Isso funciona para …

15 rest  api  api-design  http