User Tools

Site Tools


webapi_swagger_documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
webapi_swagger_documentation [2018/07/12 10:00 (6 years ago)] gking_windwardsoftware.comwebapi_swagger_documentation [2018/09/20 11:35 (6 years ago)] – [Retrieving The Documentation] jdayanan
Line 10: Line 10:
 ===== Endpoints ===== ===== Endpoints =====
  
-There are multiple endpoints available for the Windward Web API each providing different functions for the Web API. These endpoints are the following:+As of the 6.2.7 Beta there are multiple endpoints available for the Windward Web API each providing different functions for the Web API. These endpoints are the following:
   - APBill   - APBill
   - Category   - Category
Line 20: Line 20:
   - Vendors   - Vendors
   - VirtualInventory   - VirtualInventory
-  - TServerMethodsWebAPI (Most methods in this endpoint are deprecated)+  - TServerMethodsWebAPI
  
 All of these endpoints can be accessed with either of the following URLs: All of these endpoints can be accessed with either of the following URLs:
Line 26: Line 26:
   * http://API_IP_ADDRESS:API_PORT/datasnap/rest/ENDPOINT   * http://API_IP_ADDRESS:API_PORT/datasnap/rest/ENDPOINT
  
-===== Known limitations =====+==== Deprecated Methods ==== 
 + 
 +As of the 6.2.7 Beta the following methods in the endpoint TServerMethodsWebAPI were deprecated: 
 +  - Customers_Insert 
 +  - Customer_Read 
 +  - Customers_Update 
 +  - Get_Customers 
 +  - List_Customers 
 +  - Parts_Read 
 +  - Parts_Update 
 +  - Get_Parts 
 +  - List_Parts 
 +  - Insert_Parts 
 +  - Get_Main_Categories 
 +  - Get_Categories 
 +  - Suppliers_Insert 
 +  - Suppliers_Read 
 +  - Suppliers_Update 
 +  - Get_Suppliers 
 +  - List_Suppliers 
 +  - Invoices_Insert 
 +  - Invoices_Get 
 +  - Invoices_Update 
 +  - Invoices_Read 
 +  - Insert_Full_Invoice 
 +  - Insert_AP_Bill 
 + 
 +Replacement methods for these newly deprecated methods can be found within the other endpoints. 
 + 
 +===== Known Limitations ===== 
 The 6.2.2 released versions of the Web API has a maximum limit of 32 concurrent connections. This limit has been removed in the 6.2.7 beta version and is now limited by how much available memory is on the server or workstation running the API. The 6.2.2 released versions of the Web API has a maximum limit of 32 concurrent connections. This limit has been removed in the 6.2.7 beta version and is now limited by how much available memory is on the server or workstation running the API.
 +
 +Due to the JSON parser that the Windward Web API uses, any '%' characters inside of JSON strings will cause internal server errors.
  
 ===== Retrieving The Documentation ===== ===== Retrieving The Documentation =====
Line 35: Line 67:
     * http://API_IP_ADDRESS:API_PORT/datasnap/rest/ENDPOINT/Swagger     * http://API_IP_ADDRESS:API_PORT/datasnap/rest/ENDPOINT/Swagger
  
-The contents of the response from the calls is the Swagger 2.0 documentation, after copying the response text and saving it into a text file use your preferred Swagger editor (we suggest [[http://editor2.swagger.io|editor2.swagger.io]]) to view the Swagger documentation.+The contents of the response from the calls is the Swagger 2.0 documentation, after copying the response text and saving it into a text file use your preferred Swagger editor (we suggest [[http://editor.swagger.io|editor.swagger.io]]) to view the Swagger documentation.
  
 After configuring your S5WebAPISvc.ini, you can view and interact with the Swagger 2.0 documentation and the Web API through a browser, without using Postman or a Swagger editor. After configuring your S5WebAPISvc.ini, you can view and interact with the Swagger 2.0 documentation and the Web API through a browser, without using Postman or a Swagger editor.
Line 53: Line 85:
   - Open the json file in a text editor and copy the contents to your clipboard   - Open the json file in a text editor and copy the contents to your clipboard
   - Open a web browser (Google Chrome, for example) and navigate to the following URL:   - Open a web browser (Google Chrome, for example) and navigate to the following URL:
-      * [[http://editor2.swagger.io|editor2.swagger.io]]+      * [[http://editor.swagger.io|editor.swagger.io]]
   - Click on the 'File' menu.   - Click on the 'File' menu.
   - Click on 'Paste JSON'.   - Click on 'Paste JSON'.
webapi_swagger_documentation.txt · Last modified: 2022/02/23 13:40 (2 years ago) by kevin