3 ms·

This gives you a pretty good feel for where it’s at: https://json-schema.org/blog/posts/future-of-json-schema https://json-schema.org/blog/posts/future-of-json-

This gives you a pretty good feel for where it’s at: https://json-schema.org/blog/posts/future-of-json-schema https://json-schema.org/blog/posts/future-of-json-schema I’m invested in it. I’m using it to provide implementation-specific validation of requests to/from a third party API. I wish there was a good macOS editor or IDEA plugin for it with autocomplete etc. The static generators from examples are obscure, ugly, minimal, and can’t account for variations. It isn’t pleasant to write, it’s tedious and slow. Nevertheless I’d rather write API validation this way, in a document, than in code.

Godel_unicode 4y ago
Have you looked at vscode? It supposedly supports json schema (https://code.visualstudio.com/docs/languages/json https://code.visualstudio.com/docs/languages/json) and I’ve been thinking about trying it out.
BuckyBeaver 4y ago
What are you trying to do in regard to your API? I just developed an extensive API definition using OpenAPI, which (as of version 3.1) is compliant with JSON Schema. I used Stoplight Studio on Mac OS, although it still doesn't fully support OAS 3.1 two years after it became the current OpenAPI standard. The support from tools and generators is terrible; there's still no apparent toolchain that supports version 3.1 from definition through code generation. Ass-dragging on 3.1 support aside, the code-generation tools out there are, in my experience, trash anyway. It's a massive hodgepodge of Java-based tools with incomplete and redundant documentation repositories all over the place, and widely varying output quality... when the tools work at all. I appreciate people giving their time to open source, but on the other hand I wasted so much time trying to make the broken tools work that I could have written my own code generator from scratch (which is what I ended up deciding to do after weeks of dicking around with OpenAPI Generator). Anyway, I was just wondering how you're using JSON Schema for API work (since you didn't mention OpenAPI).
- throwawaymaths 4y ago
  It's kind of insane how stoplight and swagger/smartbear still don't support OpenAPI 3.1 Half tempted to just start building out OA3.1 stuff to replace those services
  - BuckyBeaver 4y ago
    This is what I was going to do too. I was just going to write a code generator in Python. And I don't even know Python. I figured it'd be easier to learn it and use it for text processing than wasting any more time trying to make the sprawling Java "tools" work.
- cjonas 4y ago
  I spent the last year and half working on a project where we planned to use OpenApi/AsyncApi to generate typed api clients and validate api requests between all our services and applications (written in typescript & C#). Going into it, I thought we'd be on a well traveled path, but that was far from the case... Typescript has some decent code generation packages (although fragmented) and request validation can be hacked via AJV... But tooling around C# was halfbaked at best. In the end, I didn't really feel like OpenApi provided the API "contract" I had originally hoped for. If I could start over, I would probably use something like gRPC for internal service communication (would maybe still use OpenAPI for any public API)
  - BuckyBeaver 4y ago
    This is exactly what I expected: a well-traveled path. I assumed I was doing something wrong or just not "getting it," and spent weeks digging through the scattered doc and poring over Java code and templates... and the generated code, which wouldn't even compile. In our case, we needed C++ for client and server... a hugely under-served scenario. Using OpenAPI and Stoplight was very useful for thinking the API through and how the whole thing could work, but the code-generation aspect was a total bust. And talking to some new colleagues later who had some knowledge of it, I found that I wasn't alone in my opinion that the tooling is trash. Even worse, the prevailing opinion on the ecosystem is so poor that it might even be a professional liability to propose (or admit to) using it. The implication was that it (or at least the code-generation facilities for it) is by and for people who don't know what they're doing. Oof.
thejosh 4y ago
The one out of the box with IntelliJ is pretty decent for checking YAMLs with JSON Schemas, is there something you're missing?
- 8n4vidtmkvmk 4y ago
  +1 it's great. It just finds the schemas all on its own. Love it. When I've written my own i had to change a setting to point it to my schema but that worked well too.
  - spockz 4y ago
    In which flavour is this? I have bunch of json and yaml files. In VS Code I can put a $schema field in the file and I get highlighting and completion. In IntelliJ I need to make file association per project to get this. And it only works for json not yaml.
- user3939382 4y ago
  Yeah, I'm writing the schema by hand to describe someone else's API by cross-referencing their API docs and the actual (integration-specific) requests/responses. So there's nothing automatic in my case beyond the native JSON support. Storm doesn't offer autocomplete based on the JSONSchema spec.

Godel_unicode 4y ago

Have you looked at vscode? It supposedly supports json schema (https://code.visualstudio.com/docs/languages/json https://code.visualstudio.com/docs/languages/json) and I’ve been thinking about trying it out.

BuckyBeaver 4y ago

What are you trying to do in regard to your API? I just developed an extensive API definition using OpenAPI, which (as of version 3.1) is compliant with JSON Schema. I used Stoplight Studio on Mac OS, although it still doesn't fully support OAS 3.1 two years after it became the current OpenAPI standard. The support from tools and generators is terrible; there's still no apparent toolchain that supports version 3.1 from definition through code generation. Ass-dragging on 3.1 support aside, the code-generation tools out there are, in my experience, trash anyway. It's a massive hodgepodge of Java-based tools with incomplete and redundant documentation repositories all over the place, and widely varying output quality... when the tools work at all. I appreciate people giving their time to open source, but on the other hand I wasted so much time trying to make the broken tools work that I could have written my own code generator from scratch (which is what I ended up deciding to do after weeks of dicking around with OpenAPI Generator). Anyway, I was just wondering how you're using JSON Schema for API work (since you didn't mention OpenAPI).

throwawaymaths 4y ago
It's kind of insane how stoplight and swagger/smartbear still don't support OpenAPI 3.1 Half tempted to just start building out OA3.1 stuff to replace those services
- BuckyBeaver 4y ago
  This is what I was going to do too. I was just going to write a code generator in Python. And I don't even know Python. I figured it'd be easier to learn it and use it for text processing than wasting any more time trying to make the sprawling Java "tools" work.
cjonas 4y ago
I spent the last year and half working on a project where we planned to use OpenApi/AsyncApi to generate typed api clients and validate api requests between all our services and applications (written in typescript & C#). Going into it, I thought we'd be on a well traveled path, but that was far from the case... Typescript has some decent code generation packages (although fragmented) and request validation can be hacked via AJV... But tooling around C# was halfbaked at best. In the end, I didn't really feel like OpenApi provided the API "contract" I had originally hoped for. If I could start over, I would probably use something like gRPC for internal service communication (would maybe still use OpenAPI for any public API)
- BuckyBeaver 4y ago
  This is exactly what I expected: a well-traveled path. I assumed I was doing something wrong or just not "getting it," and spent weeks digging through the scattered doc and poring over Java code and templates... and the generated code, which wouldn't even compile. In our case, we needed C++ for client and server... a hugely under-served scenario. Using OpenAPI and Stoplight was very useful for thinking the API through and how the whole thing could work, but the code-generation aspect was a total bust. And talking to some new colleagues later who had some knowledge of it, I found that I wasn't alone in my opinion that the tooling is trash. Even worse, the prevailing opinion on the ecosystem is so poor that it might even be a professional liability to propose (or admit to) using it. The implication was that it (or at least the code-generation facilities for it) is by and for people who don't know what they're doing. Oof.

thejosh 4y ago

The one out of the box with IntelliJ is pretty decent for checking YAMLs with JSON Schemas, is there something you're missing?

8n4vidtmkvmk 4y ago
+1 it's great. It just finds the schemas all on its own. Love it. When I've written my own i had to change a setting to point it to my schema but that worked well too.
- spockz 4y ago
  In which flavour is this? I have bunch of json and yaml files. In VS Code I can put a $schema field in the file and I get highlighting and completion. In IntelliJ I need to make file association per project to get this. And it only works for json not yaml.
user3939382 4y ago
Yeah, I'm writing the schema by hand to describe someone else's API by cross-referencing their API docs and the actual (integration-specific) requests/responses. So there's nothing automatic in my case beyond the native JSON support. Storm doesn't offer autocomplete based on the JSONSchema spec.