Skip to content

Response Codes

Flynn, Conor edited this page Dec 7, 2022 · 5 revisions

Introduction

Listed below are all response codes that can be returned by the engine. The codes can both be observed through communication within the engine as well as through responses from the REST API. Listed below are the categories these codes are grouped into:

Code Range Title
000 Blank
200 - 209 General Success Codes
220 - 229 External Stream Success Codes
400 - 409 Routing Connection Issue Codes
410 - 419 Routing Processing Issue Codes
420 - 439 External Stream Processing Issue Codes
440 - 459 Local Stream Processing Issue Codes
460 - 469 Output Consumer Issues Codes
470 - 479 Output Producer Issues Codes
500 - 599 General Issues Codes

Response Code List

Listed below are all response codes that can be returned by the engine internals or external calls.

Code Title Description Solution
000 Blank Return used for test cases and default applications. This response should never be generated, if returned please contact developer.
200 Response OK Request was performed successfully. No action required.
220 Stream with given hash exists A stream using the given credentials already exists, using the previously generated stream. No action required.
400 Router not connected Internal error with Router communication. The Routers are on separate managers and cannot communicate packets between one another. Check implementation for validity.
404 Destination not found Router could not find another Router with the given tag to send the Packet to. Validate Router connections. Check implementation for validity.
405 Subtag not found at destination No subtag action was found at the Tag given. Validate Router with given Tag to make sure function with subtag is implemented properly.
406 Delimiter used in API request An illicit API request is made using a delimiter for transferring the data to the engine. Remove the delimiter from the API request.
407 Malformed packet The Packet data parameter is malformed. Make sure each data point passed to the packet contains a key and a value passed as: "key", "value".
410 Router process failure The Router could not process the given method. Make sure the method contained in the Router is formatted properly.
420 Source does not exist Requested data source does not exist. The data source requested does not exist, validate the request and the implementation.
421 StreamKey does not exist A Stream with the given key does not exist. Make sure the stream is properly initialized prior to requesting.
422 Data source unable to authorize The data source could not be authorized with the given credentials. Make sure the authorization implementation is valid or the given authorization details are valid.
423 Stream is not ready to be executed The stream cannot be used because it is not ready to be executed. Check the implementation and the authorization parameters for validity.
424 Stream is already active An active stream cannot be re-executed. No action required.
425 Stream is not active A non-active stream cannot be killed. No action required.
426 Subscription type not found Source does not contain subscription type. Check the implementation and the request for validity.
427 Irregular subscription response The data source returned irregular message when attempting to subscribe to the service. Check the service's status and the subscription implementation.
428 Request type does not exist The data source does not have the given request type available. Check the implementation and the request for validity.
429 Irregular request response The data source returned an irregular message when attempting to request data from external service. Check implementation and external service for validity.
430 Invalid stream hash Stream key could not be generated from given properties. Check the implementation of the stream key generation.
440 Source does not exist Requested data source does not exist. Check the implementation and the request for validity.
441 Data source is not ready Data source is not ready to handle queries. Validate the source is ready to be used.
442 Data source unable to be added Data source could not be added. Check the implementation and all external resources the local stream uses for validity.
443 Data source already exists Data source given given hash already exists. No action required.
444 Failed to authorize data source Data source could not be successfully authorized. Check the implementation and authorization parameters for validity.
445 Invalid query The query made to the local source could not be validated. Make sure the query passed is in the proper format.
446 Data source does not contain queried data The query passed does not return any stored data. Check implementation for validity.
447 Query had unexpected failure Query could not be properly handled by local stream. Check the implementation using the query for validity.
448 Invalid state query or data instance Local database determined query to be invalid or data to be invalid. No action required.
449 Failed to push data to local stream Local database could not push data to given location. Check implementation and local database status for validity.
460 Consumer failed to listen Output consumer failed to successfully listen to consumption channel. Check the implementation, REST API implementation, and the server port security for port 61100 all for validity.
470 Producer failed to accept new socket Producer failed to accept and maintain new socket from external connection. Check the implementation and the external program implementation for validity.
471 Producer key does not exist Destination key of socket to push external data to does not exist in system. Validate the external socket connection and the passed key.
472 Producer failed to send data Producer failed to push data to external source. Check implementation and external socket connection.
500 Empty required parameter Call is missing required parameter. Include required parameter in request.
501 Fatal error occurred Fatal error in engine has occurred such as corrupted memory. Locate source in implementation to debug. This code should never be seen.
502 Internal language failure Internal language failed to recognize command. Caused by protocol being misinterpreted. Check implementation for validity.
503 Invalid date format Passed date object is not in the proper format specified by the engine. Write date parameter with valid formatting.