đ§ââī¸Create API Test
Conektto's Autonomous API Test Studio
Upload API specification, connect data store, let Conektto's NLP engine does the magic of attributes to entity mapping, you are now ready to publish and create your API test harness.
Log in to Conektto
Go to www.conektto.io. The Conektto page displays.
Select Sign up/Login.The Conektto Login/Sign up page displays.
Select Continue with Linkedin. The Linkedin Login page displays.
Enter Email ID and Password, and select Sign in. The Conektto Authenticator page displays.
Select Allow. The Conektto API project page displays that allows you to create an API project.
Create a Test API Project
Follow instructions from 1 to 6 in the Log in to Conektto section.
Select Test Studio. The Test API Project page displays.
Select Create New API Project. The Create API Project page displays.
Enter the API Name and select Upload to upload the specification file.
Select the Connect Database tab.
Select SQL Server as the Server Type.
Enter 34.82.24.189 in the Host field and 1433 in Port field.
Enter Username, Password, and Database.
Note: Select Over SSL checkbox to upload Key, Certificate, and CA Certificate.
Select the Invite Collaborators tab to enter name of people in the Invite users to collaborate.
Note: Select skip for now if you do not want to enter any collaborator's name.
Select Next.
Video Overview
Check out a video overview of our product below.
Create your API tests
â From Conektto dashboard, Click on "Create New API"
â
Click on Test Studio dialog
â
Type a name for your API Test Project
Upload Spec
â
Upload API Specification (JSON)
Upload your desired API Specification for which you would like to build tests.
If you would like to try out our examples, select "Use default BikeStore Spec" and click Next to add collaborators.
Connect Database
â
Click Next to connect your database
Select Database Server Type, and provide host credentials for the desired database under test. You may also choose to connect to your database through SSL. You are required to upload your SSL certificates if you choose to do so. Click "Test" to test the database connection. If you have trouble in connecting the database, check "Support" section for additional details.
Invite Collaborators
â
Click on "Invite Collaborators"
APIs are no good designed, built or tested in silos. Invite your desired users or stakeholders that you would like to share the API test project by providing their email id. The respective users will get an email with a link for collaboration.
â
Click on "Done" to continue with collaborators or "Skip for now" to add collaborators later
â
Conektto's engine now scans your API schema, your database, runs our patent pending NLP matching process before loading your API test studio designer.
â ī¸This process may take several minutes based on the complexity of your schema, database and volume of data.
â
After successful scanning and matching, you will be presented with Test Studio with all your schema resources pre-loaded with RestAPI contracts as well as established matches as Full Match, Partial Match or No Match
Examine Schema and Simulate payload
â Visually examine the Schema
Inspect the operations pre-loaded from the Schema and examine for correctness and completeness of RestAPI operations and contracts.
â Visually simulate the payload
âšī¸Click "SEND" to simulate the request, response payload structure.
Pre-Publish: Validations and Mapping
After confirming the contracts, click "Publish"
Publish action prepares your API contracts, schema and entities selected for validation against OpenAPI standards as well as mapping complex business logic.
â
Validations
Conektto assures thorough validation of API standards. The following are various levels of validations if not addressed, your publish would fail:
Naming conventions
Descriptions, optional and mandatory parameters
Correctness of Operations and components
Completeness of Operations Status codes
Bare minimum structure of a RestAPI contract (Header, Request Body, Response Body)
đMandatory mappings
âšī¸For Conektto to publish API test artifacts, schema attributes are required to be mapped with database entities. You will be prompted with below mandatory mapping steps:
â ī¸Select appropriate attributes and respective entities to be mapped. Click "Save and Publish"
â
Business logic: Relationship, joins and filters
â ī¸Conektto allows users to validate existing entity relationships. Where the database is not normalized, you are able to define custom mapping between the entities. Additionally users can create Filter conditions for the API.
âī¸Derived Entity Maps - preloaded maps based on database schema scanning
âī¸User Defined Entity Maps - custom maps defined by user
âī¸Filters - custom filter conditions annotated by user
â ī¸You will be prompted to confirm the database host credentials for final domain model validation.
â
Completing Publish
âšī¸Click "Publish". Conektto will create your Autonomous API Test Harness ready to be downloaded from the Dashboard.
Last updated