Apidog Docs
πŸ‡ΊπŸ‡Έ English
  • πŸ‡ΊπŸ‡Έ English
  • πŸ‡―πŸ‡΅ ζ—₯本θͺž
HomeLearning CenterSupport CenterAPI References
HomeLearning CenterSupport CenterAPI References
Discord Community
Slack Community
X / Twitter
πŸ‡ΊπŸ‡Έ English
  • πŸ‡ΊπŸ‡Έ English
  • πŸ‡―πŸ‡΅ ζ—₯本θͺž
  1. Get started
  • Apidog Learning Center
  • Get started
    • Introduce Apidog
    • Basic concepts in Apidog
    • Navigating Apidog
    • Quick Start
      • Overview
      • Specify a new endpoint
      • Make a request to the endpoint
      • Add an assertion
      • Create a test scenario
      • Share your API documentation
      • Explore more
      • Send a request and save as an endpoint
    • Migration
      • Overview
      • Manual import
      • Scheduled import
      • Import options
      • Export data
      • Import from...
        • Import from Postman
        • Import OpenAPI (Swagger) spec
        • Import cURL
        • Import Markdowns
        • Import from Insomnia
        • Import from apiDoc
        • Import .har file
        • Import WSDL
  • Design APIs
    • Overview
    • Create a new API project
    • Endpoint basics
    • Components
    • Common fields
    • Global parameters
    • Endpoint change history
    • Batch endpoint management
    • Configure multiple request body examples
    • Schemas
      • Generate Schemas from JSON etc.
      • Build a schema
      • Overview
      • Create a new schema
    • Security schemes
      • Overview
      • Create a security scheme
      • Use the security scheme
      • Security scheme in online documentation
    • Advanced features
      • Custom endpoint fields
      • Import endpoints as test steps
      • Endpoint status
      • Appearance of parameter lists
      • Endpoint unique idenfication
  • Develop and Debug APIs
    • Overview
    • Generate requests
    • Send requests
    • Endpoint cases
    • Dynamic values
    • Validate responses
    • Design-first Mode & Request-first Mode
    • Generate code
    • Environments & variables
      • Overview
      • Using variables
      • Environments & services
    • Vault secrets
      • Overview
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Pre/Post processors
      • Overview
      • Assertion
      • Extract variable
      • Wait
      • Database operations
        • Overview
        • MongoDB
        • Redis
        • Oracle Client
      • Using scripts
        • Overview
        • Postman scripts reference
        • Pre processor scripts
        • Post processor scripts
        • Public scripts
        • Calling other programming languages
        • Using JS libraries
        • Visualizing responses
        • Script examples
          • Assertion scripts
          • Using variables in scripts
          • Using scripts to modify request messages
          • Other examples
    • Dynamic values Modules
  • Mock API data
    • Overview
    • Smart mock
    • Custom mock
    • Mock priority sequence
    • Mock scripts
    • Cloud mock
    • Self-hosted runner mock
    • Mock language (Locales)
  • Automated tests
    • Overview
    • Test reports
    • Test scenarios
      • Create a test scenario
      • Pass data between requests
      • Flow control conditions
      • Import endpoints/endpoint cases from other projects
      • Sync data from endpoints/endpoint cases
      • Export test scenarios
    • Run test scenarios
      • Run a test scenario
      • Data-driven testing
      • Run test scenarios in batch
      • Scheduled tasks
      • Manage the runtime environment of APIs from other projects
    • Test APIs
      • Integration testing
      • Performance testing
      • End-to-end testing
      • Regression testing
    • Apidog CLI
      • Overview
      • Installing and running Apidog CLI
      • Apidog CLI Options
    • CI/CD
      • Overview
      • Integrate with Jenkins
      • Integration with Gitlab
  • Publish API Docs
    • Overview
    • API Technologies Supported
    • Quick share
    • View the API documentation
    • Publish docs sites
    • Folder tree settings
    • Custom layouts
    • Visibility settings
    • Endpoint SEO settings
    • Custom domain
    • Embedding values in document URLs
    • Documentation Search
    • Integrating Google Analytics with Doc Sites
    • CORS Proxy
    • API Versions
      • Overview
      • Create API versions
      • Publish API versions
      • Share endpoints with API versions
  • Send requests
    • Overview
    • gRPC
    • Use request proxy agents for debugging
    • SOAP/WebService
    • GraphQL
    • WebSocket
    • Socket.IO
    • SSE debugging
    • Create requests
      • Request History
      • Request basics
      • Parameters and body
      • Request headers
      • Request settings
      • HTTP/2
    • Authentication and authorization
      • Overview
      • CA and client certificates
      • Authorization types supported by Apidog
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk Authentication
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Response and cookies
      • Overview
      • API response in Apidog
      • Create and send cookies
      • Debug requests
      • Save the request as an endpoint
  • Branches
    • Overview
    • Create a new sprint branch
    • Test APIs in a branch
    • Design API in a branch
    • Merge sprint branches
    • Manage sprint branches
  • Apidog MCP Server
    • Overview
    • Conntect API Specification within Apidog Project to AI via Apidog MCP Server
    • Conntect Online API Documentation Published by Apidog to AI via Apidog MCP Server
    • Conntect OpenAPI Files to AI via Apidog MCP Server
  • Best practices
    • How to handle API signatures
    • How to access OAuth 2.0 protected APIs
    • Apidog collaboration workflow
    • Managing authentication state in Apidog
  • Administration
    • Onboarding Checklist
      • Basic Concepts
      • Onboarding Guide
    • Managing Teams
      • Managing Teams
      • Managing Team Members
      • Member Roles & Permission Settings
      • Team Activities
      • Team Resources
        • General Runner
        • Team Variables
        • Request Proxy Agent
      • Real-time Collaborations
        • Team Collaboration
    • Managing Projects
      • Managing Projects
      • Managing Project Members
      • Notification Settings
      • Project Resources
        • Database Connection
    • Managing Organizations
      • Single Sign-On (SSO)
        • SSO Overview
        • Configure Microsoft Entra ID
        • Configure Okta
        • Configure SSO for an Organization
        • Managing user accounts
        • Mapping Groups to Teams
      • SCIM Provisioning
        • Intro to SCIM Provisioning
        • Microsoft Entra ID
        • Okta
      • Organization Resources
        • Self-hosted Runner
  • Billing
    • Overview
    • Credits
    • Unable to use credit cards?
    • Managing subscriptions
    • Upgrade plan
  • Add-ons
    • API Hub
    • Apidog Intellij IDEA plugin
    • Browser Extension
      • Chrome
      • Microsoft Edge
    • Request Proxy
      • Request proxy in Apidog web
      • Request proxy in shared docs
      • Request proxy in Apidog client
  • Account & preferences
    • Language settings
    • Data backup
    • Network proxy configuration
    • Hot keys
    • Updating Apidog
    • Generate OpenAPI access token
    • Deleting account
    • Account settings
  • References
    • API-Design First Approach
    • Apidog OpenAPI Specificaiton Extensions
    • JSONPath
    • XPath
    • Regular Expressions
    • JSON Schema
    • CSV File Format
    • Install Java Environment
    • Runner deployment environment
    • Apidog flavored Markdown
  • Apidog Europe
    • Apidog Europe
  • Support Center
  1. Get started

Navigating Apidog

The main interface of Apidog can be broadly divided into the following parts:
Header
Sidebar
Workbench
Directory tree
Tabs
Environment selector
Footer
image.png
This layout provides a structured and user-friendly interface for working with various aspects of API development and testing within the Apidog platform.

Header#

The header includes the following main functions:
image.png
Home: Takes you to your personal homepage, displaying the teams you've joined, including team members, team projects, team Plan, organizations you belong to, API hub, and more.
Project Tabs: Each tab represents a project. Click to switch between projects. Clicking the button to the left of the project name opens the project in a separate window.
Upgrade/plan: Shows the current Plan being used by your Team.
Refresh: Reloads the data of the current project; reloading will close all currently open content tabs.
Settings: Local settings, where you can set Appearance, proxy, and other settings related only to the current client and not to the logged-in user.
Notifications: Displays alerts from team activities that require your attention.
Avatar: Account settings, where you can set basic account information, Access tokens, etc.

Sidebar#

The Sidebar contains the following features:
Project Icon: Click to jump to Teams and projects.
APIs: Apidog's core interface where you can define APIs, debug APIs, send requests, create Schemas, write Markdown, and more.
Tests: If you need to send requests in batch (similar to running a Postman Collection) or orchestrate data relationships and sending logic between requests, you can create a test scenario in Tests. Here, you can also view test reports, run performance tests, manage test data, integrate CI/CD, and more.
Share docs: Once APIs are defined, you can share them with other colleagues in this module, or officially publish them as API documentation. You can define the documentation interface, customize domain names, and more here.
History: All requests that have been sent can be viewed and resent in the History section.
Settings: All settings related to the current project are here, including basic settings, function settings, notification settings, project resources, and project data import/export.
Invite: Invite other users to join the current project.

Workbench#

Directory tree#

The directory tree includes the following functional modules from top to bottom:
Branches and Versions: Default is the main branch, you can switch to other branches, create new branches, or manage branches.
Search and Filter: You can search and filter endpoints. Note that currently, you can only search for endpoint names, not folder names or case names.
Create New: You can create various types of elements, such as endpoints, requests, schemas, Markdown, etc.
Overview: An overall view of the project
Endpoints: Endpoints and endpoint cases organized in a folder structure; Markdown and Websocket, etc., can also be mixed in.
Schemas: Schemas organized in a folder structure
Components: Reusable components. Currently only supports response components.
Requests: API requests organized in a folder structure, similar to Postman's Collection.
Trash: Deleted endpoints, schemas, components, requests, etc., will enter the trash and be automatically deleted after 30 days.

Tabs#

Clicking any element in the directory tree will open a Tab.
Tabs include the following types:
Endpoint
Schema
Component
Markdown
Folder
Request
WebSocket
Overview
Trash
New
When you single-click to open a Tab, you'll notice that the Tab title is in italic font. In this italic state, if you click another element in the directory tree, the old tab will be overwritten. This is suitable for browsing scenarios.
If you make any changes to the Tab content, the Tab title will change to normal font. In the normal font state, clicking another directory tree element will open a new tab, which is suitable for editing scenarios.
If you want the opened tab not to be overwritten by other tabs, you can also use double-click to open the tab. This will directly put the tab into the normal font state.
There are two buttons on the far right of the Tabs:
New: You can create various types of elements
More: You can close all tabs, or close the current tab, or close all tabs except the current one.

Footer#

image.png
From left to right, the footer includes:
Collapse/Expand: Can collapse or expand the directory tree.
Online: Indicates online status. If offline, there will be issues with team synchronization.
Agent: A feature exclusive to Apidog Web, allows you to select which Agent will send out the requests for Apidog Web.
Cookies: Cookie manager, can store current cookies
Community: Links to the Apidog Community, including Discord, Slack, Teams, X, and Email.
Appearance: Can change Apidog's background color, theme color, and font size.
Help: Opens the help documentation
Modified atΒ 2025-02-07 10:00:26
Previous
Basic concepts in Apidog
Next
Overview
Built with