Preguntas etiquetadas con api-design

En este artículo, el autor afirma que A veces, se requiere exponer una operación en la API que inherentemente no es RESTful. y eso Si una API tiene demasiadas acciones, es una indicación de que fue diseñada con un punto de vista RPC en lugar de usar principios RESTful, o …

24 rest  domain-driven-design  api-design  cqrs 

Suponiendo un sistema donde hay una aplicación web con un recurso y una referencia a una aplicación remota con otro recurso similar, ¿cómo representa una acción de sincronización bidireccional que sincroniza el recurso 'local' con el recurso 'remoto'? Ejemplo: Tengo una API que representa una lista de tareas pendientes. GET …

23 api  rest  api-design  synchronization 

Estoy diseñando una API REST pragmática y estoy un poco atascado en la mejor forma de agregar entidades existentes a una colección. Mi modelo de dominio incluye un proyecto que tiene una colección de sitios. Esta es una relación estricta de muchos a muchos y no tengo necesidad de crear …

23 rest  api-design 

Estoy creando una API, una función que carga un archivo. Esta función no devolverá nada / nulo si el archivo se cargó correctamente y genera una excepción cuando hay algún problema. ¿Por qué una excepción y no solo falsa? Porque dentro de una excepción puedo especificar la razón del fallo …

22 java  api-design  exceptions  functions  architectural-patterns 

Recientemente he estado desarrollando mi propia API y con ese interés invertido en el diseño de la API, me ha interesado mucho cómo puedo mejorar mi diseño de la API. Un aspecto que ha surgido un par de veces es (no por los usuarios de mi API, sino en mi …

20 programming-practices  naming  api  api-design 

En un libro de SO acabo de leer que "las API públicas son para siempre: solo una oportunidad para hacerlo bien" ¿Es verdad? ¿Es aplicable solo en las API de sistemas operativos u otras API también? Por ejemplo, ¿será esto cierto para las API de aplicaciones de Android como Tasker, …

20 android  api  api-design 

Cerrada . Esta pregunta está basada en la opinión . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que pueda ser respondida con hechos y citas editando esta publicación . Cerrado hace 5 años . Esto es para colecciones ordenadas, por ejemplo, java.util.List. ¿Por qué …

19 java  api-design 

Después de estar expuesto a numerosas capas de abstracción de bases de datos, empiezo a preguntarme cuál es el punto de que cada biblioteca invente su propio paradigma diferente para acceder a los datos. Elegir un nuevo DAL se siente como aprender un nuevo idioma nuevamente, cuando generalmente todo lo …

18 database  sql  api-design  dsl 

Estamos desarrollando una API Rest para el sitio web de comercio electrónico que será consumida por las aplicaciones móviles. En la página de inicio de una aplicación, debemos llamar a múltiples recursos como Sliders, Top Brands, Best Selling Products, Trending Products, etc. Dos opciones para realizar llamadas API: Llamada única …

18 rest  api  api-design  url 

¿Por qué los diseñadores de Java no crearon versiones estáticas de métodos de manipulación de cadenas en la java.lang.Stringclase? A los que me refiero son los siguientes métodos, pero la pregunta también puede extenderse a otros métodos no estáticos en la clase. concat(String) substring(int, int) replace(char, char) toLowerCase() replace(CharSequence, CharSequence) …

17 java  api-design  null 

Acabo de leer un artículo interesante llamado Cómo ser demasiado lindo con retorno de rendimiento de C # Me hizo preguntarme cuál es la mejor manera de detectar si un IEnumerable es una colección real enumerable, o si es una máquina de estado generada con la palabra clave de rendimiento. …

17 c#  api-design 

Estoy usando una biblioteca interna que fue diseñada para imitar una biblioteca C ++ propuesta , y en algún momento en los últimos años veo que su interfaz cambió de usar std::stringa string_view. Así que obedientemente cambio mi código, para adaptarme a la nueva interfaz. Desafortunadamente, lo que tengo que …

16 c++  api-design  strings 

Tengo dos recursos: usuarios y enlaces. Los usuarios pueden tener varios enlaces asociados con ellos. He diseñado mi API RESTful para que pueda acceder a los enlaces asociados con un usuario en el siguiente URI: /users/:id/links Sin embargo, siempre necesito tener un URI solo para enlaces, a veces podría querer …

16 api  rest  api-design 

Es muy común especificar la versión de las API REST en la URL, específicamente al comienzo de la ruta, es decir, algo como: POST /api/v1/accounts GET /api/v1/accounts/details Sin embargo, no he visto ningún diseño en el que la versión esté asociada con cada API. En otras palabras, mantenemos la versión …

15 rest  api-design  versioning  enterprise-architecture  engineering 

Estamos diseñando una API RESTful destinada principalmente a satisfacer las necesidades de un solo cliente. Debido a sus circunstancias muy particulares, este cliente tiene que hacer la menor cantidad de solicitudes posible. La API maneja i18n a través de un encabezado Accept-Language en las solicitudes. Esto funciona para todas las …

15 rest  api  api-design  http