RESTHost - Deployment
How to deploy?
To deploy and start a RESTHost service:
- In the Linx Designer, click the Deploy button in top menu.
- In the pop-up, configure your Linx Server’s Server URL, User and Password fields.
- Click Deploy & Open Server
- Once the Solution has been uploaded and started, you will automatically be navigated to the Linx Server front end.
- Log into the Linx Server dashboard.
- Navigate into the Solution services and find the RESTHost service that you created and turn it ON.
- The RESTHost service is now activated.
Once this is done the service will monitor for incoming requests and send responses. Incoming requests as well as the subsequent results of the operations are logged and can be viewed on the services dashboard.
Linx Designer and Server view:
Common Deployment Issues
Accessing ‘localhost’ externally
A common issue is that the Base URI prefix is set to “localhost” i.e.
When deploying to the Linx Server, in order to use the local host of the server as the Base URI, use the
This wildcard character (+) will ‘grab’ the current local hostname to generate the Base URI.
Start Solution failed
If you see the upload dialog like below, this means that there is a fatal error in the application and the application cannot compile (invalid references, incomplete expressions etc).
This means that the Solution cannot compile due to there being a design error in terms of logic. To view the issue, click on the more option and address the specific error.
Base URI Conflict
The issue described above is due to there being more than a single RESTHost service that is configured on the same Base URI.
The Base URI can only be used to host a single RESTHost service. If you have multiple RESTHost services in your solution, ensure that they are using unique Base URIs. If an active service shares the same Base URI as a newly deployed Solution, the existing service will take preference.
Invalid Object Reference
The below error describes an invalid reference within the Solution, this means that at runtime the reference does not contain any value and thus cannot be used.
Normally, in the Designer, if you have invalid references you will be shown them:
However, certain properties may have valid references in the Designer, but at runtime the values contained in these references are NULL.
Typically, this occurs in operations when individual child fields are set before the whole parent object is initiated.
There is an issue at the SetValue function in the OperationEvents_BeforeOperation event:
Technically, this is a valid reference (that is why there are no error validations visible in the Designer); however at runtime an error is thrown because the parent
Server Runtime Errors
If an unhandled error occurs during runtime on the Server such as an error with a request, it will appear on the service dashboard in red:
You are able to view a detailed stack trace of the error by navigating to the Log option on the left panel.
Internal Server Error – No Log Entry
If you are receiving 500 (InternalServerError) responses when making a request to a Linx web service and there is nothing in the Server Log, this indicates that there is an issue with the authentication setup of the RESTHost service with regards to the Bearer Authentication scheme attached to an operation.
If you configure the RESTHost service Return server errors as True, then when you make the request again, the error will be included in the response.
If the response is similar to the above, please ensure that you have configured the Auth config correctly by referencing the signing key used in the generation of the JWT Tokens.
Other guides for hosting a REST API
View our sample solution on GitHub.