Today, we are releasing JSight CLI 1.1.0. It helps you to work with the JSight API language in a user console. The main feature of the current release is the ability to convert JSight API descriptions to OpenAPI definitions.
Syntax error messages have also been greatly improved: they are more detailed, accurate and include links to the documentation.
More details on the product: JSight CLI.
The official release page can be found here: JSight CLI 1.1.0 Release Notes.
Today we release a new version of JSight Online Editor 6.0.
The official release page is here.
From now on, JSight supports OpenAPI 3.0. Now you can design your APIs in the JSight language and instantly convert them to the OpenAPI format.
We also fixed some minor bugs, improved usability, and made the syntax error messages more accurate.
Today, we are releasing JSight CLI 1.0.0. It helps you to work with JSight API language in a user console. The current release has the following features:
More details about the product: JSight CLI.
The official release page may be found here: JSight CLI 1.0.0 Release Notes.
Today, we are releasing JSight VS Code Extension 1.0.0. It helps you edit the JSight API specification in your favourite IDE.
VS Code Marketplace link: https://marketplace.visualstudio.com/items?itemName=jsight.jsight.
More details about the product: JSight VS Code Extension.
The official release page may be found here: JSight VS Code Extension 1.0.0 Release Notes.
Today we are releasing JSight Java Validator 1.0.0.
This is a library, which validates all your API requests and responses against your API specification, written with JSight API language.
More details about the product: JSight Validator.
The official release page may be found here: JSight Validator Java Adapter 1.0.0 Release Notes.
Today, we are releasing a new version of JSight Validator PHP Extension 1.0.1.
This is a PHP extension, which validates all your API requests and responses against your API specification, written with JSight API language.
More details about the product: JSight Validator.
The official release page may be found here: JSight Validator PHP Extension 1.0.1 Release Notes.
Today, we are releasing a new product: JSight Validator.
This is a library that is designed to validate all incoming and outgoing API messages for compliance with the API specification written in the JSight API language.
It works as follows:
Now all API calls will be validated by the JSight Validator against the API specification! This will provide you with the following benefits:
For example, in PHP, HTTP request validation might look like this:
$error = jsight_validate_http_request(`my-api-spec.jst`, $method, $uri, $headers, $body);
if( $error ) return jsight_serialize_error('json', $error);
More details about the product: JSight Validator.
We are very excited to announce the release of a new version of JSight Online Editor 5.0.
The official release page is here.
From now on, JSight supports the JSON-RPC 2.0 protocol. Now you can design and document your JSON-RPC APIs with the same ease as general REST APIs.
In addition, we fixed a few minor bugs and improved the usability.
You can read more about working with the JSON-RPC protocol here.
We are happy to announce the release of a new version of JSight Online Editor 4.0..
The official release page is here.
Main feature of the release: You can now share API documentation via a unique link. All you need to do is click on the “Share” button and copy the link.
We also thought about versioning the API documentation. It can be done like this:
Sharing documents via a link will provide you with three fantastic benefits:
Another major update in release 4.0 is improved JSight syntax highlighting. Now the editor accurately highlights all the syntax features of the JSight API language.
Hi everybody! We have a new release of JSight Online Editor 3.0! The official release page may be found here: JSight Online Editor 3.0 Release Notes.
There are two cool features in this version:
Firstly, “Preview” and “Export” buttons are added. By using these buttons, you can see the final API documentation design and, if you like it, download it in HTML format.
Secondly, we have added macros support into the JSight language. And it's really very cool! JSight now looks like a true programming language (programmers will understand us). With the directive MACRO, you may now declare a macro, and with the directive PASTE, you may paste this macro anywhere in your API an unlimited number of times. Macros are useful, for instance, for quick attachment of standard responses to each resource in case of an error. As an example:
GET /cats
200 [@cat]
PASTE @commonErrors
GET /dogs
200 [@dog]
PASTE @commonErrors
MACRO @commonErrors
(
400 any
401 any
405 any
500 any
)
You can read more about the directives MACRO and PASTE in the JSight language specification:
We have also improved the UX in some places and fixed a few minor bugs.
We plan to release the next version of JSight Online Editor 4.0 by the end of May. The main innovation of this version will be the “Share” button. With this button, you will be able to save documentation in the cloud and share it with colleagues just by sending them a unique link to the document.
We also hope to add JSON-RPC support to the JSight language in the near future.