Services in Nordcraft simplify working with APIs by automatically retrieving endpoint details from backend 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 backend services:

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

There are two ways to add a service in Nordcraft:

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 from the options

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 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 it's added, Nordcraft checks the connection to confirm it can reach the API documentation.

To make your 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, they simplify the API creation process by providing pre-defined endpoints from your backend:

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 backend 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 backend service changes, updating the connection in one place applies across all related APIs

Services help bridge the gap between frontend and backend development, making it easier to maintain a clean separation of concerns while ensuring proper integration.