Services

Introduction

Services make working with APIs much simpler. When you create a service, toddle will automatically pull information about the APIs available on that service and pre-fill all the required information when creating new APIs.

Supported Services

Currently, toddle supports the following services:

• Supabase
• Xano
• Any service using OpenAPI Specification (v2 and v3).

Adding a Service

To add a service, click on "Connect new" when creating a new API-

You can also connect a service through the "Services" section in the files sidebar and then click on the "+"

You will be presented with a dialog to choose one of the supported services or add a custom service.

Supabase

Select the Supabase option from the list of services. You will be asked to provide a "Project URL" and an "API Key". Both of these can be found in the settings of your Supabase project:

1. Go to your Supabase and select the project you wish to connect
2. Copy the Project URL ① and the "anon public" key ② and add them in toddle.

Toddle will validate the endpoint once both have been added to ensure we can get the documentation using the provided API key.

Xano

To add a Xano service, select the Xano option from the list of services. You will be asked to provide the Base URL. This URL can be found by selecting "API" in the left menu in your Xano workspace. From here, select the API group you want to use and then click "Copy Base URL" button in the right-hand corner of the page:

Paste this URL into the Base URL field in toddle. Once added, toddle will validate the endpoint to ensure we can get the documentation from it.

NOTE: Currently, we only support public documentation. If your Xano API documentation is private, you must make it public so you can use it in toddle. This can be done from the settings of your Xano API group. To allow public access to your documentation, do the following:

1. Go to the API group you want to use in toddle.
2. Click on the "More options" button in the top right corner (three dots).
3. Select "Settings".
4. Change the "Swagger (OpenAPI) Documentation" setting to "Public".

Custom service

If you use a service toddle does not support, you can add a custom service. To do this, select the "Custom" option from the list of services. You will be asked to provide the following:

• Base URL: This is the URL we will use for all paths in the service.
• Docs Url: This is the service's OpenAPI Specification file URL.

Note: We currently support OpenAPI Spec v2 and v3.

Using a service in an API

Once you have added a service, you can use it to create a new API. When creating a new API, you can select an endpoint from the service in the intro screen. This will automatically prefill the path, headers, query parameters, and body with information pulled from the service. You can then update values such as body or path parameters with the correct values for your use case.