Business
Jobs
  • About Us
  • Solutions
    • Job Postings
      Post your job and receive qualified candidates in 48h.
    • Candidate Assessments
      500+ technical and psychological tests, plus anti-fraud.
    • Headhunting
      Tailor-made executive search from start to finish.
    • Payroll + EOR
      Payroll dispersal and EOR across 15+ LATAM countries.
  • Pricing
  • Jobs

0

287
Views
JSON schema vs. Open API - Java support

I came across this JSON schema specification here.

http://json-schema.org/understanding-json-schema/

I wonder if it's related in some way to the Open API spec.

https://swagger.io/specification/

  1. To what extent are both specs standard ones? I know Open API is widely used but is it really adopted by the major companies as a de-facto standard?

  2. Which one has better support in Java and is "more" standard?
    I mean e.g. from which type of API definition, you can more easily generate client side classes to use in your client code?

  3. Imagine you have an API which you need to consume (via a Java client e.g.). What would you ask for from your API provider, would you ask for a JSON schema API definition, or for an Open API based API definition?

over 4 years ago · Santiago Trujillo
2 answers
Answer question

0

The first link is a documentation site, discussing JSON Schema, whose official site is here and whose specification is here. JSON Schemas are used for describing and validating data structures of all kinds (as long as they can be represented by the JSON document model), but it has wide usage within HTTP applications.

Swagger is now known as OpenAPI (with the move to version 3.x). Its official site is here and the latest specification is here. It uses JSON Schemas internally as part of its data structure. It specifically targets the description (and sometimes validation) of HTTP requests and responses.

Both sites have indexes of implementations in various platforms and languages.

over 4 years ago · Santiago Trujillo Report

0

To what extent are both specs standard ones? I know Open API is widely used but is it really adopted by the major companies as a de-facto standard?

Both are extremely widely used and, yes, they are industry standards.

Which one has better support in Java and is "more" standard? I mean e.g. from which type of API definition, you can more easily generate client side classes to use in your client code?

JSON schema's primary purpose is not to specify APIs. OpenAPI is tailor-made for that. As said by @Ether, It uses JSON Schemas internally as part of its data structure. If your aim is to generate Java from an API spec, choose OpenAPI (assuming your API is REST or at least REST-ish).

Imagine you have an API which you need to consume (via a Java client e.g.). What would you ask for from your API provider, would you ask for a JSON schema API definition, or for an Open API based API definition?

OpenAPI, as per the previous explanations. :)

over 4 years ago · Santiago Trujillo Report
Answer question
Find remote jobs

Discover the new way to find a job!

Top jobs
Top job categories
Business
Post vacancy Pricing Sales
Legal
Terms and conditions Privacy policy
© 2026 PeakU Inc. All Rights Reserved.
Andres GPT
Show me some job opportunities
There's an error!