darrelmiller

7 ms·

1.
by darrelmiller 8y ago
The site is back, but I this was a sufficient kick in the ass to finally get the blog moved onto a proper platform.
2.
by darrelmiller 8y ago
Well that's embarrassing.
3.
by darrelmiller 9y ago
Hence the reason for tools like swagger-inflector http://swagger.io/writing-apis-with-the-swagger-inflector/ that allows you to drive routing directly from the OpenAPI definition
4.
by darrelmiller 9y ago
The text is different but the meaning is the same. A GET body must not have an effect on the request/response. i.e. You can have one, but you are not allowed to use it for anything.
5.
by darrelmiller 9y ago
We use OpenAPI in many other places too. Azure Logic Apps, Azure API Management, Azure Functions, Azure API Apps, Microsoft Flow, PowerApps. And the list just keeps getting longer. Also, the new Microsoft Docs site is driven off OpenAPI.
6.
by darrelmiller 9y ago
We have been having numerous conversations within Microsoft to figure out how to describe Graph API using OpenAPI. The new Links capability helps a lot. Also, the AnyOf support will help with describing URLs with Expand. There are still a
7.
by darrelmiller 9y ago
You are correct that the Swagger name is owned by Smartbear, however, whereas previously Swagger was used to name tooling and the specification, now Swagger only refers to the tooling built by Smartbear. OpenAPI V2 and V3 is the name of ju
8.
by darrelmiller 9y ago
It makes it hard to take advantage of HTTP caches. There is also some redundancy because SOAP has headers and HTTP has headers. Which to use? It also is handy to be able to make idempotent requests, especially over flakey networks.
9.
by darrelmiller 9y ago
The one distinction that I think is worth making is that OpenAPI describes HTTP APIs using the semantics of HTTP. Corba and SOAP attempted to be protocol independent. That's much harder to do well. Another good aspect of OpenAPI is t
10.
by darrelmiller 9y ago
This issue list on the OpenAPI GitHub repo is full of requests for change. The spec hasn't changed in a long time, and although this is a fairly big change, it shouldn't be a particularly difficult change for tooling folks to ada
11.
by darrelmiller 9y ago
By declaring conformance to YAML 1.2 and requiring conformance to the JSON Schema ruleset defined in YAML 1.2 we can ensure that any YAML OpenAPI document can be converted into JSON without any loss of information.
12.
by darrelmiller 9y ago
OpenAPI V3 now supports AnyOf and OneOf constructs from JSON Schema.
13.
by darrelmiller 9y ago
We're not :-)
14.
by darrelmiller 9y ago
Yes, we decided to be opinionated and say you can't describe bodies for operations where the spec says bodies have no meaning. The text should be there, but I think the RC0 revision has some formatting issues that is hiding the text.
15.
by darrelmiller 9y ago
Hey Gregory, thanks for the article. Would it be possible to change your title to OpenAPI 3 and not Swagger 3.0? Swagger is the name of the tooling produced by Smartbear that supports OpenAPI and they just released new versions of their S
16.
OpenAPI Spec v3 Implementer’s Draft is ready(openapis.org)
6 points by darrelmiller 10y ago|0 comments
17.
by darrelmiller 11y ago
They thought about it... "Some URI Templates can be used in reverse for the purpose of variable matching: comparing the template to a fully formed URI in order to extract the variable parts from that URI and assign them to the named va
18.
by darrelmiller 12y ago
For some additional insight on accept based conneg. The guys who created it, really wish they hadn't. http://www.alvestrand.no/pipermail/ietf-types/2006-April/001... "Regarding proactive negotiatio
19.
by darrelmiller 13y ago
Link relations can be designed that indicate which HTTP methods are allowed. HAL is heavily dependent on conveying semantics via link relations, which is something that some people don't like doing. Consider the oauth2-token link rela
20.
by darrelmiller 13y ago
By having a framework "handle this" you teach novice devs that they don't have to think about it and then they do stuff the framework can't fix and wonder why the framework is broken!
21.
by darrelmiller 14y ago
Web API is actually built on a completely different HTTP pipeline than ASP.NET products. When it moved to the ASP.NET team, there were a number of changes made to make it feel more natural to ASP.NET devs. Hence the slight variations when
22.
by darrelmiller 14y ago
If you like Jinja2 then use it. We have been using it for templating, running with IronPython, for the last couple of years.