xapi-logo
Solutions icon
Features icon
Resources and Support icon
PricingXapi HubPublic Editor xapi editor
Start Xapi For Free
Getting Started
Xapi | Quick Start

Quick Start Guide

Are you new to Xapi? Let’s do a quick start!

Being the flagship product of X-Venture (opens in a new tab), Xapi is a full-fledged API designing and governance tool that is carefully designed to manage API requirements, API designs, as well as the stakeholders.

Xapi stands out from the other API solutions out there by enabling the ability to manage note only APIs from their inception to going live but the crew that puts their heart and soul to make them a reality by using an abstraction called Organization. An Xapi organization is a virtual entity that can house APIs, API models, API projects, and even API teams that will be working on APIs.

Depending on the time and money you would want to spend on us, we have segregated three different types of quick starts:


Image description

Quick start to default Xapi Organization

This Quick Start Guide helps you to explore Xapi features with default organization that gets automatically generated when you sign up with Xapi.



What you will achieve This quick start guide helps you to:

  • Step 1: Create APIs
  • Step 2: Design APIs
  • Step 3: Review APIs

Before you begin

  1. Access the Xapi portal here Sign in (opens in a new tab).

Image description

💡

Tip: Haven’t signed up with Xapi yet? Click on Register to sign up. For instructions, see Signing up with Xapi.

  1. Sign in. For instructions, see Signing in to Xapi. Note that the dashboard of your default Xapi organization appears.
ℹ️

Info: To learn about Xapi organizations, see Xapi organizations.

Now that you have successfully signed in to Xapi, let’s create an API in your default organization!

Step 1: Create API

To create an API:

  1. Click CREATE > API > New API.

    Note that the New API form opens.

  2. Enter the API details.

    Open API version3.1
    API version1.0
    API nameCofee Shop API
    ProjectDefault Project
    Collection pathDefault collection path
    FormatJSON
    ProtocolREST
  3. Click Create. Note that you will be navigated to the API editor screen.

Congratulations! You have successfully created your very first API with Xapi. Let’s flesh out your API design!

Step 2: Design API

To design the API that you created:

  1. On the API editor screen and copy the following code snippet in the middle pain. Cofee Shop - Code Snippet (opens in a new tab)
📃

Note: that the Details tab in the right pane gets populated with Cofee Shop operations that are defined in the copy-pasted code snippet.

  1. Try adding coffee shop operations using the sample values.

Now that you have made edits to your API, let’s learn how to review and comment on API designs!

Step 3: Review API

To review and add comments to your API:

  1. Place your cursor on a preferred line of the code in the central pane. Note that the Comment icon appears at the left.

  2. Click on the Comment icon and add the following text.

💡

Tip: You can use @ symbol to mention another Xapi user to whom you may be adding this comment.

  1. Click Add. Note that your profile icon appears on the line that you commented.

This brings to the end of the Quick Start to Xapi default organizations. We recommend you to explore the following topics:

  • Quick start to free organizations
  • Quick start to premium organizations
  • Managing your API team (Organizations, projects, and teams)
  • Managing your APIs (APIs, models, catalogs, and collection paths)
  • Managing your API requirements (features, improvements, bugs, kanban)

Quick start to Xapi Organization

This quick start guide helps you to explore free Xapi features by creating an Xapi organization from scratch.



Scenario

John Doe is the owner of a software development organization that has divisions:

  • A division that maintains its own product suite for healthcare
  • A division that does software development projects in different domains such as healthcare and insurance.

Both of these projects involve creating and maintaining APIs. Along with the software application evolution that takes place within the product and projects, the associated APIs also get numerous requests to improve (API requirements).

John Doe who intends to increase the overall productivity of the organization and its projects is interested in maintaining the following with Xapi:

  • Organization
  • Organization members
  • Organization APIs artifacts
  • Projects
  • Project members
  • Project APIs and artifacts

Let’s assume you are John Doe and check out how to manage the above-mentioned entities with Xapi!

What you will achieve

This Quick Start Guide guides you to:

  • Step 1: Create an Xapi organization for John Doe’s organization
  • Step 2: Invite organization members to John Doe’s organization
  • Step 3: Create a project under John Doe’s organization
  • Step 4: Assign team members to a project
  • Step 5: Create APIs
  • Step 6: Create Kanban ticket and attach API
  • Step 7: View Kanban Board
  • Step 8: Add comment to API

Before you begin

  1. Access the Xapi portal at URL.

Image description

💡

Tip: Haven’t signed up with Xapi yet? Click on Register to sign up. For instructions, see Signing up with Xapi.

  1. Sign in. For instructions, see Signing in to Xapi. Note that the dashboard of your default Xapi organization appears.
ℹ️

Info: To learn more about Xapi organizations, see Xapi organizations.

Now that you have successfully signed in to Xapi, let’s create an organization!

Step 1: Create an organization and invite members

To create a premium organization your software development organization:

  1. Click CREATE > Organization.

    Note that the New organization form opens.

  2. Select the Premium plan.

📃

Note: that the New premium organization form opens with the package set to premium.

💡

Tip: By default, the Private Organization switch is turned on. You may turn it off and set the organization visibility to public.

  1. Enter the organization details and click Next.

    Organization nameXYZ Org
    AilasXYZOrg

    Note that you will be navigated to the INVITE tab.

  2. Enter an email ID of a person whom you want to collaborate with via this Xapi organization and select an appropriate role, e.g., Admin.

💡

Tip: As user invites require confirmation by the invitee, for testing purposes we recommend using an own email and respond to the confirmation email.

  • Click Next. Note that you will be navigated to the Avatar tab.
  • Select a preferred avatar and click Next. Note that you will be navigated to the Review tab.
  • Click Proceed to billing. Note that you will be navigated to the dashboard screen of your newly created Xapi organization.

The dashboard presents:

  • Activity stream: This lists down the activities that takes place within your organization.
  • Recent API catalogs: This displays the recently used API catalogs of your organization. Info: Xapi API catalogs enable grouping APIs, API models, and API collections. For more information on Xapi API catalogs, see Link.
  • Recent projects: This displays the recently used projects of your organization. Info: For more information on Xapi projects, see Link

Now that you have successfully created a premium Xapi organization, let’s invite more members to your organization!

Step 2: Invite organization members

To invite more members to your premium organization:

  1. Click on the profile icon and select Settings.

  2. Click People.

    Note that you will be navigated to the People screen.

  3. Click INVITE. Note that the Invite People screen appears.

  4. Enter an email ID of a person whom you want to collaborate with via this Xapi organization and select an appropriate role, e.g., Member.

ℹ️

Tip: As user invites require confirmation by the invitee, for testing purposes we recommend using an own email and respond to the confirmation email.

  1. Click Invite.

Now that you have invited more members to your organization, let’s create a project under the organization you just created.

💡

Tip: Make sure to activate the Xapi user accounts of the email IDs that you entered in [Step 2] and [Step 3].

Step 3: Create project

To create a project under the organization that you created:

  1. While remaining on the People screen, click CREATE > Project.

Note that the New Project form opens.

  1. Enter the project details and click Next.
Project nameHealthStar
Project-level API CatalogSelect Info: Project-level API catalogs enable to syndicate all the APIs that are related to the corresponding project.
Project board templateFixed Kanban BoardInfo: Project board templates enable you to select the visual format of the project-related task management.
Task AilasXYZHealthS
📃

Note: that you will be navigated to the AVATAR tab.

  • Select a preferred avatar and click Next. Note that you will be navigated to the People tab.
  • Enter an email ID of an organization member whom you want to select for this project.
  • Click Next. Note that you will be navigated to the Review tab.
  • Click Create Project. Note that you will be navigated to the dashboard screen of your newly created Xapi project.

The dashboard presents:

  • API Collections: This widget displays the [API collections] in this project.
  • Contributors and Stats: This widget displays the top project contributors and project stats.
  • Activity stream: This widget displays the activities that takes place within your project.
  • Tickets assigned to you: This widget displays all the tasks that are assigned to you in this project.
  • Attachments: This widget displays if any files attached to this project.

Now that you have successfully created a project, let’s assign more members to your project!

Step 4: Assign project team members

To assign more members to your project:

  1. On the Projects menu, click View all projects.

  2. Click Add People in the project tile.

📃

Note: that you will be navigated to the Add Members screen.

  1. Enter an email ID of a person whom you want to collaborate with via this Xapi organization and select an appropriate role, e.g., Member.
💡

Tip: As user invites require confirmation by the invitee, for testing purposes we recommend using an own email and respond to the confirmation email.

  1. Click Add Members.

Now that you have invited more members to your project, let’s create an API in your project.

Step 5: Create API

ℹ️

Info: Xapi enables you to create APIs within organizations and projects.

To create an API in your project:

  1. Click CREATE > API > New API.

    Note that the New API form opens.

  2. Enter the following API details and click Next.

    Open API version3.1
    API Version1.0
    API NameEnter a preferred name.
    ProjectSelect the newly created project.
    Collection pathThis is the [API repository] in which this API will be created.
    FormatJSON
    ProtocolREST
  3. Note that you will be navigated to the Review tab.

  4. Click Create API. Note that you will be navigated to the API editor screen.

Now that you have created an API, let’s learn how to create a [Kanban ticket] to enhance the newly created API!

Step 6: Create Kanban ticket and attach API

To create a Kanban ticket:

  1. Click CREATE > Task.
📃

Note: that the Create new Kanban ticket screen appears.

  1. Enter the following Kanban task details and click Create.

    ProjectSelect the newly created project.
    TaskFeature
    APISelect the newly created API.
    TitleEnter a preferred feature name, e.g., Add new verb.
    PrioritySelect a preferred a priority.

Now that you created a Kanban ticket, let’s view the Kanban ticket in the Kanban Board!

Step 7: View Kanban Board

To view Kanban Board:

  1. On the API Catalogs menu, select your project catalog.

  2. Click Kanbn on the left-navigation pane.

    Note that the newly created Kanban ticket appears under the TO DO column.

  3. Do the following updates to the ticket and close the ticket:

    • Select yourself as the Assignee.
    • Select the Status to Design in Progress.
📃

Note: that the Kanban ticket has moved from the TO DO column to DESIGN IN PROGRESS column. Similarly, you can move the Kanban ticket to other statuses depending on your user role within the project.

Now that you have learned how Kanban Ticket state transition takes places, let’s learn how to comment an API.

Step 8: Add comment to API

To add a comment to an API:

  1. Click on the search icon and search for your API.

  2. Navigate to the API editor screen.

  3. Select a code line in the central pane.

📃

Note: that the Comment icon appears on the selected code line.

  1. Click on the Comment icon.
  2. To assign the comment to a user, click on the @ icon and enter a username. For testing purposes, you can add your own username.
  3. Add a comment, e.g., Comment this line.
  4. Click Add. Note that a notification appears.

Congratulations! You have successfully completed the Xapi Quick Start Guide!

What’s Next?

Learn more about: