Handling errors the GraphQL way and adding more results to your queries​

We've updated response status codes and now allow up to 1000 results per query.​

Vendia Engineers worked tirelessly to improve our product and leverage industry standards.. Here are the newest updates!

Error handling the way it should with GraphQL.

GraphQL errors are not scary as long as they are returned and properly handled. In the past Vendia Share would return 4XX and 5XX status codes for any http request failures. But that has changed with a move to GraphQL's recommended approach.

In short, it means the GraphQL end point will always return a 2XX. But, when an error occurs, an errors field will be included in the response payload. Note that this does not mean our end point will never return anything else. This change is at handler level. It means once your request actually reach GraphQL handler, you will only get 2XX. Here's a table for the changes:

ScenarioPrevious Status CodeCurrent Status Code
Rate Limit Sync Mutation400200
Malformed Graphql Request400200
Sync mutation timeout400200
Internal Server Error400200

Here's two examples using Curl:

1. A request with typo in it's query. n is intentionally removed in listVendia_BlockItems:

curl 'https://<some-domain>/graphql/' \
    -H 'Authorization: <api-token>' \
    -H 'content-type: application/json' \
    -H 'accept: application/json' \
    -i \
    --data-raw '{"query":"query blocksQuery {  listVedia_BlockItems {    Vendia_BlockItems {      blockId      blockHash    }  }}","variables":null,"operationName":"blocksQuery"}'

We can see that it returns 200 status code. But also gives detailed error messages pointing out that listVedia_BlockItems is incorrect and suggested other available options.

Sample Response:

HTTP/2 200
date: Tue, 29 Nov 2022 20:31:27 GMT
content-type: application/json
content-length: 288
x-amzn-requestid: XXXXXX
access-control-allow-origin: *
x-amz-apigw-id: XXXXXX
x-amzn-trace-id: XXXXXX

{"data": null, "errors": [{"message": "Cannot query field 'listVedia_BlockItems' on type 'Query'. Did you mean 'listVendia_BlockItems', 'listVendia_FileItems', 'listVendia_FolderItems', 'listVendia_ApiKeyItems', or 'listVendia_ContractItems'?", "locations": [{"line": 1, "column": 22}]}]}%

2. A request with meaningless query body:

curl 'https://<some-domain>/graphql/' \
    -H 'Authorization: <api-token>' \
    -H 'content-type: application/json' \
    -H 'accept: application/json' \
    -i \
    --data-raw '{"query":"query "}'

Again, we see a 200 status code. The message informs us that the syntax is not right which makes sense since our query body has nothing.

Sample Response:

HTTP/2 200
date: Tue, 29 Nov 2022 20:31:52 GMT
content-type: application/json
content-length: 124
x-amzn-requestid: 6097318d-f50d-4097-b415-82e6a8f07652
access-control-allow-origin: *
x-amz-apigw-id: cYXYzEpbyK4FsBg=
x-amzn-trace-id: Root=1-63866c38-38b964043a2d77c240da4981;Sampled=0

{"data": null, "errors": [{"message": "Syntax Error: Expected '{', found <EOF>.", "locations": [{"line": 1, "column": 7}]}]}%

See common GraphQL error handling techniques for more information on properly handling errors.

Up to 1000 for your query results

As the number of entities increase, the result set for list operations will be too large to return in a single http response. To optimize resource usage, Vendia continues limits results to 1000 results per query. However, in cases where a filter is applied, Vendia previously did not fully populate the result set. With some recent changes, each page of results should be more complete (i.e. fewer if any empty pages) than they were previously.

Here are couple samples in a testing environment.

  1. A basic query with limit set to 1000:
GraphQL UI 1
  1. A query attempt to set limit for more than 1000:
GraphQL UI 2

Believe in Real-Time Data Sharing?

Vendia leads the way in data sharing and business blockchains. Get started for free to see how Vendia can power your business..

Calendly Embed

Contact Us

Connect with Vendia!

Thank you for your interest in Vendia. We see the opportunity to unlock value, increase efficiency, and fuel growth.

Please use the form to submit your inquiry, and our team will respond within 1-2 business days.

Vendia is committed to protecting and respecting your privacy, and we’ll only use your personal information to administer your account and to provide the products and services you requested from us. From time to time, we would like to contact you about our products and services, as well as other content that may be of interest to you.