Services

Services in Nordcraft simplify working with APIs by automatically retrieving endpoint details from back-end providers. When you create a service connection, Nordcraft pre-fills the necessary information for new APIs, reducing setup time and minimizing configuration errors.

Nordcraft supports connections to a variety of back-end services:

• Supabase: Open-source Postgres database with authentication and real-time capabilities
• Xano: No-code database and API builder
• OpenAPI: Any service using the OpenAPI Specification (v2 and v3)

You can add services in Nordcraft in two ways.

Add a service from API panel

1. 1

   When creating a new API, click the Connect new button
2. 2

   Select the service you want to connect to from the available options

Add a service from project sidebar

1. 1

   Open the project sidebar by clicking the folder icon or using Cmd/Ctrl + K
2. 2

   Navigate to the Services section and click the + button to add a new service
3. 3

   Select your desired service

Configure Supabase service

To connect to Supabase:

1. 1

   Enter a name for the service (defaults to "Supabase")
2. 2

   Provide the following credentials:
   • Project URL: The URL of your Supabase project
   • Anon public key: The anonymous/public API key for your project

You can find these credentials in your Supabase project settings. Once the Supabase service is added, Nordcraft will validate the connection to ensure it can access the API documentation.

Configure Xano service

To connect to Xano:

1. 1

   Enter a name for the service (defaults to "Xano")
2. 2

   Provide the Base URL for your Xano API

The Base URL can be found in your Xano workspace:

• Select API in the left menu
• Choose the API group you want to use
• Click the Copy base URL button in the top right corner

After the Xano service is added, Nordcraft checks the connection to confirm it can reach the API documentation.

To make your Xano API documentation public:

1. 1

   Go to your Xano API group
2. 2

   Click the More options button (three dots) in the top right
3. 3

   Select Settings
4. 4

   Change Swagger (OpenAPI) Documentation to Public

Configure custom service

For services not natively supported by Nordcraft, you can add a custom service using OpenAPI specification:

1. 1

   Enter a name for the service (defaults to "Custom")
2. 2

   Configure the following:
   • Base URL: The root URL that will be applied to all paths in the service
   • Docs URL: The URL to the OpenAPI JSON Specification file of the service

Nordcraft performs a check after setup to confirm the API documentation is accessible.

Once your services are configured, the API creation process becomes simplified by providing pre-defined endpoints from your back end:

1. 1

   When creating a new API, you will see your connected services
2. 2

   Choose the endpoint from the available options of your selected service
3. 3

   Nordcraft automatically pre-fills all request details ( path, headers, parameters, body)
4. 4

   Adjust specific values as needed for your implementation

This approach streamlines API creation by leveraging the schema information already defined in your back-end service.

Connecting to services offers several advantages:

• Reduced configuration time: Automatically populate API endpoints with correct paths and parameters
• Consistency: Ensure proper formatting for requests based on the service's documentation
• Discovery: Easily browse available endpoints without referring to external documentation
• Maintainability: When your back-end service changes, you can update the connection in one place to be applied across all related APIs