Pull APIs into the API Platform from remote Git repositories

Description

Description

The goal of this feature is to enable users to import (pull) API artifacts from remote Git repositories into the API Platform to easily create and manage APIs designed externally.

User Story

As a user,
I want to pull API projects from a remote Git repository (public or private)
so that I can import APIs designed using the API Designer into the API Platform without manually uploading files.

Users can design APIs locally using the API Designer, where each project is identified by a .api-platform folder.
This folder contains:

config.yaml – defines project configuration, including references to OpenAPI and API definition files

The API project contains

• openapi.yaml – the OpenAPI specification of the API
• api.yaml – the API definition file
• API Documentation
• Certificates

Once designed, the project can be pushed to a remote Git repository (public or private).
The API Platform will then support pulling these API projects directly from the repository to create an API.

Flow

1. Select Repository Source

• Option 1: Public repository
• Option 2: Private repository

2. Provide Repository URL

• The user enters the Git repository URL.

3. Fetch Repository Details

• The platform lists available branches in the repository.
• Once a branch is selected, the platform displays the directory structure.

4. Select API Project Directory

• The user selects a directory path that should contain the .api-platform folder.
• If the selected directory does not contain a valid .api-platform folder (with required files), show a validation error.

5. Pull API Artifacts

• If valid, pull the following artifacts:
  • openapi.yaml
  • api.yaml
• Additional assets such as documentation files and certificates.

6. Populate API Creation Form

• Use the pulled details to pre-fill the API creation form in the platform.
• Display API metadata and available resources for review before creation.

Acceptance Criteria

• Ability to pull from public Git repositories
• Ability to pull from private Git repositories (with authentication if needed)
• Lists branches and directory structure for the selected repo
• Validates presence and structure of .api-platform folder
• Successfully imports openapi.yaml, api.yaml, and related assets
• Populates API creation form with fetched data
• Displays validation or error messages when applicable