Preguntas etiquetadas con api-design

17
Detectando IEnumerable "Máquinas de Estado"

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

16
Cuándo usar recursos anidados en una API RESTful

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

16
¿Cuándo debo usar string_view en una interfaz?

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

15
¿Qué tienen en común las grandes API? [cerrado]

Cerrada . Esta pregunta necesita estar más centrada . Actualmente no está aceptando respuestas. Cerrado hace 6 años . Bloqueado . Esta pregunta y sus respuestas están bloqueadas porque la pregunta está fuera de tema pero tiene un significado histórico....

15
RESTful API e i18n: ¿cómo diseñar la respuesta?

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

13
¿Cuándo debo usar AtomPub?

He estado realizando algunas investigaciones sobre el diseño de servicios web RESTful y he llegado a lo que creo que es un punto de decisión clave, así que pensé en ofrecerlo a la comunidad para obtener algunos consejos. De acuerdo con los principios de una arquitectura RESTful, quiero presentar...

13
Usar composición y herencia para DTO

Tenemos una API web ASP.NET que proporciona una API REST para nuestra aplicación de página única. Usamos DTO / POCO para pasar datos a través de esta API. El problema ahora es que estos DTO se hacen más grandes con el tiempo, así que ahora queremos refactorizar los DTO. Estoy buscando "mejores...

12
Diseño de API de biblioteca C ++

Estoy buscando un buen recurso para aprender sobre un buen diseño de API para bibliotecas de C ++, mirar objetos / dlls compartidos, etc. Hay muchos recursos para escribir buenas API, buenas clases, plantillas, etc. a nivel fuente, pero casi nada sobre poner cosas juntas en libs y ejecutables...

12
Mantener API versus usar modismos en un puerto

Estoy trabajando en un puerto de Python a Rust y encontré un código que no se puede expresar de forma tan natural en Rust como en Python. Un caso de esto es el uso de parámetros predeterminados: class Foo: def __init__(self, a="Hello"): self._a = a En Rust, puede implementar esto usando un...

12
¿Debo ser permisivo con los parámetros desconocidos?

Estoy diseñando una API RESTful y me enfrenté al problema del título, reformulado para mayor claridad: ¿Debo fallar rápidamente si un cliente envía un parámetro no reconocido? Por ejemplo, http://example.com/api/foo?bar=true&paula=bean En lo anterior, bares un parámetro válido pero paulano...

12
¿JSON plano o anidado para datos jerárquicos?

He cambiado de ida y vuelta ~ 5 veces ya. Este punto final REST /api/tags/será para uso interno (sin clientes de terceros), soy el único que trabaja con él. Estoy decidiendo entre estas dos representaciones: Plano { "types":[ { "id":1, "text":"Utility" }, { "id":7, "text":"Lease...