A step-by-step guide to taking Aito into use

1. Your personal keys for your Aito environment

You have received your API keys and URL to your environment via the welcoming email. Store the keys safely as you need them to set up your Aito environment!

2. Set up your Aito environment

You can start testing out Aito either by using a Curl command or by using Aito’s interactive Swagger UI.

  1. Via Curl command
    Please try out the environment by accessing https://aitoai-ecom-demo.api.aito.ai/version with the following command:

    Command:

    curl -X GET \
       --header 'x-api-key: READ-ONLY-API-KEY' \
       --header 'Content-Type: application/json' \
       https://aitoai-ecom-demo.api.aito.ai/version
    
    

    The query tests the connection to the environment and responds with details about the version of the environment. See an example below:

    {
      "name":"aitoai-core-v2",
      "version":"382",
      "gitRevision":"010b5125fbb5c9cd85542d14ccab320beefc73d5",
      "builtAt":"2018-09-12T10:25:50.352Z"
    }
    
  2. Via Aito’s interactive Swagger UI
    You can access Aito’s Swagger UI documentation via this link: https://aitoai-ecom-demo.api.aito.ai/api-docs/v3/

    Via the “Authorize” button on the right, you can add your either one of your personal keys. To test the connection, we recommend you to use your read-only key. If you want to upload data, you’ll need to use your write key.

    You can use the Swagger UI to test out that your keys are working and that you can access Aito’s environment.

3. Once you have Aito up and running: start testing!

Start taking Aito into use via the following steps:

The full API documentation is available under: https://aitoai-ecom-demo.api.aito.ai/docs/v1/api/index.html

And the more technical, interactive Swagger-documentation for the API via this link: https://aitoai-ecom-demo.api.aito.ai/api-docs/v3/

Note that the documentation and the API format is still work-in-progress, so changes are to be expected!

4. Start experimenting with Aito via the online training module

We have created a training module, allowing you to make a “basic” grocery store app intelligent with Aito.

The exercises are focussing on these features:

We highly recommend you to try out the training, to understand Aito better. The whole training should take less than 45 minutes: https://github.com/AitoDotAI/grocery-store-demo-app

5. Contact us for support and feedback

The fastest way to contact us is via support@aito.ai. We welcome any kind of suggestions and feedback on your user experience! We aim to get back to you within 2 working days.