arnaudlauret - Network
Mastodon API wins the post txt message race. Twitter is 2nd just because it's impossible to get a Bearer Token on dev portal for such a...
https://hachyderm.io/@arnaudlaur...Mastodon API wins the post txt message race. Twitter is 2nd just because it's impossible to get a Bearer Token on dev portal for such a request. LinkedIn is far behind because a page is needed to create app, 2 requests needed, and doc & API design & error feedback are terrible.
27.1.2023 17:56Mastodon API wins the post txt message race. Twitter is 2nd just because it's impossible to get a Bearer Token on dev portal for such a...https://hachyderm.io/@arnaudlaur...
When showing or editing an OpenAPI document, we can talk about infrastructure and API gateways when defining servers. 🪡 🔚#api #openapi
https://hachyderm.io/@arnaudlaur...When showing or editing an OpenAPI document, we can talk about infrastructure and API gateways when defining servers. 🪡 🔚
#api #openapi
https://hachyderm.io/@arnaudlaur...
When showing or editing an OpenAPI document, we can teach HTTP protocol when choosing an HTTP method under paths./some-path or a status code...
https://hachyderm.io/@arnaudlaur...When showing or editing an OpenAPI document, we can teach HTTP protocol when choosing an HTTP method under paths./some-path or a status code under responses in an operation. 🪡
#api #openapi
https://hachyderm.io/@arnaudlaur...
When showing or editing an OpenAPI document, we can stress the importance of standards and API governance while discussing the...
https://hachyderm.io/@arnaudlaur...When showing or editing an OpenAPI document, we can stress the importance of standards and API governance while discussing the not-that-obvious consequences of choosing the names of properties in a schema. 🪡
#api #openapi
https://hachyderm.io/@arnaudlaur...
When showing or editing an OpenAPI document, we can explain API design concerns, like how it is important to set the boundaries of an API...
https://hachyderm.io/@arnaudlaur...When showing or editing an OpenAPI document, we can explain API design concerns, like how it is important to set the boundaries of an API with a name (info.title) and a description (info.description or info.summary). 🪡
#api #openapi
https://hachyderm.io/@arnaudlaur...
When showing or editing an OpenAPI document, we can tell stories about the format itself. For instance, when setting openapi value to 3.0.3...
https://hachyderm.io/@arnaudlaur...When showing or editing an OpenAPI document, we can tell stories about the format itself. For instance, when setting openapi value to 3.0.3 or 3.1.0, we can explain the origin of the format (don't call it swagger 2.0 anymore). 🪡
#api #openapi
https://hachyderm.io/@arnaudlaur...
Beyond being a vehicle for the description of an API, an API specification such as the OpenAPI specification can support various narratives....
https://hachyderm.io/@arnaudlaur...Beyond being a vehicle for the description of an API, an API specification such as the OpenAPI specification can support various narratives. 🧵
#api #openapi
https://hachyderm.io/@arnaudlaur...
Interested in API design and OpenAPI? Join @iandouglas736 and me today at 5 PM CET for the weekly #PostmanLIVE...
https://hachyderm.io/@arnaudlaur...Interested in API design and OpenAPI? Join @iandouglas736 and me today at 5 PM CET for the weekly #PostmanLIVE https://www.youtube.com/watch?v=JEBd78U9aBo #api #apidesign #openapi
5.1.2023 10:44Interested in API design and OpenAPI? Join @iandouglas736 and me today at 5 PM CET for the weekly #PostmanLIVE...https://hachyderm.io/@arnaudlaur...
I’ll probably give a try to mermaid too (before diving again in D3JS). PlantUML allows to link a property to a class, mermaid doesn’t...
https://hachyderm.io/@arnaudlaur...I’ll probably give a try to mermaid too (before diving again in D3JS). PlantUML allows to link a property to a class, mermaid doesn’t but not sure that’s a big issue.
20.12.2022 18:29I’ll probably give a try to mermaid too (before diving again in D3JS). PlantUML allows to link a property to a class, mermaid doesn’t...https://hachyderm.io/@arnaudlaur...
(it was not the end of the 🧵yet) The diagram is a bit of a mess so each object/class has a specific color, and all links pointing to it...
https://hachyderm.io/@arnaudlaur...(it was not the end of the 🧵yet) The diagram is a bit of a mess so each object/class has a specific color, and all links pointing to it are of the same color.
20.12.2022 18:22(it was not the end of the 🧵yet) The diagram is a bit of a mess so each object/class has a specific color, and all links pointing to it...https://hachyderm.io/@arnaudlaur...
And as just having the parent was not enough, I wanted all the parents but struggled with circular references. So, for now, I'm...
https://hachyderm.io/@arnaudlaur...And as just having the parent was not enough, I wanted all the parents but struggled with circular references. So, for now, I'm generating a class diagram of the #OpenAPI structure (transforming my JSON data to a PlantUML diagram). #api 🪡 🔚
20.12.2022 18:07And as just having the parent was not enough, I wanted all the parents but struggled with circular references. So, for now, I'm...https://hachyderm.io/@arnaudlaur...
As I was struggling to evaluate some Spectral paths, I just added the places where an #OpenAPI object is used #api 🪡
https://hachyderm.io/@arnaudlaur...As I was struggling to evaluate some Spectral paths, I just added the places where an #OpenAPI object is used #api 🪡
20.12.2022 18:02As I was struggling to evaluate some Spectral paths, I just added the places where an #OpenAPI object is used #api 🪡https://hachyderm.io/@arnaudlaur...
The #OpenAPI map v2 alpha has been online for a while now: I have some python magic extracting data from the md documentation to JSON files....
https://hachyderm.io/@arnaudlaur...The #OpenAPI map v2 alpha has been online for a while now: I have some python magic extracting data from the md documentation to JSON files. They are rendered in HTML/JS (it's ugly, but I just use it to see what I got). https://arno-di-loreto.github.io/openapi-specification-documentation-as-data/oas-data-viewer-web-component/ #api 🪡
20.12.2022 17:59The #OpenAPI map v2 alpha has been online for a while now: I have some python magic extracting data from the md documentation to JSON files....https://hachyderm.io/@arnaudlaur...
A few years back, I created the #OpenAPI map to help me figure out the spec structure. The data is manually extracted from the markdown...
https://hachyderm.io/@arnaudlaur...A few years back, I created the #OpenAPI map to help me figure out the spec structure. The data is manually extracted from the markdown specification. Updating to 3.1 would take a day of work, so I'm spending weeks on automation😅 🧵#api https://openapi-map.apihandyman.io/
20.12.2022 17:54A few years back, I created the #OpenAPI map to help me figure out the spec structure. The data is manually extracted from the markdown...https://hachyderm.io/@arnaudlaur...
"Weeeeeeebfinger 🎺🎺🎺".Just discovered the Webfinger protocol. Am I the only one hearing Shirley Basset when reading this...
https://hachyderm.io/@arnaudlaur..."Weeeeeeebfinger 🎺🎺🎺".
Just discovered the Webfinger protocol. Am I the only one hearing Shirley Basset when reading this name? (I'm deeply sorry if that was not the case until now 😆) https://webfinger.net/
https://hachyderm.io/@arnaudlaur...
It should be mandatory that any organization (corporate or government) let users access their own data via their regular APIs on the same...
https://hachyderm.io/@arnaudlaur...It should be mandatory that any organization (corporate or government) let users access their own data via their regular APIs on the same base as what they can get using the organization's mobile application or website. #api
19.12.2022 13:56It should be mandatory that any organization (corporate or government) let users access their own data via their regular APIs on the same...https://hachyderm.io/@arnaudlaur...
They were so many great sessions, but here are my top 3 I recommend watching as soon as they're available:- "60 years of APIs"...
https://hachyderm.io/@arnaudlaur...They were so many great sessions, but here are my top 3 I recommend watching as soon as they're available:
- "60 years of APIs" by @mamund
- "The State of API industry" by Mark O'Neill
- "API Governance 3.0 - A collaborative foundation for the next 10 years of APIs" by Patrick Brosse and Mark Weitzel
#api #apidaysParis 🧵🔚
https://hachyderm.io/@arnaudlaur...
10 years of API Days and video adapters are still an issue 😅 (lowering the Macbook output refresh rate may solve problems).#api...
https://hachyderm.io/@arnaudlaur...10 years of API Days and video adapters are still an issue 😅 (lowering the Macbook output refresh rate may solve problems).
#api #apidaysParis 🧵
https://hachyderm.io/@arnaudlaur...
It's still (unfortunately) important to remind that it's OpenAPI (3) and not Swagger (2) anymore. (Here's a recap and video of...
https://hachyderm.io/@arnaudlaur...It's still (unfortunately) important to remind that it's OpenAPI (3) and not Swagger (2) anymore. (Here's a recap and video of my "OpenAPI does what Swagger don't" session https://blog.postman.com/openapi-does-what-swagger-dont/)
#api #apidaysParis 🧵
https://hachyderm.io/@arnaudlaur...
Do-it-all API gateway-saurus (© Mark O'Neill) are dying species leaving room for more specialized tools. More focused and decentralized...
https://hachyderm.io/@arnaudlaur...Do-it-all API gateway-saurus (© Mark O'Neill) are dying species leaving room for more specialized tools. More focused and decentralized API gateways (bye-bye hyper centralized ESBs-like gateways) need tools around them. Also, I feel that third-party API management and governance is an area to explore more.
#api #apidaysParis 🧵
https://hachyderm.io/@arnaudlaur...