Apidog Docs
Apidog Agent
The Apidog Agent allows you to send API requests when you're using the Apidog web app. This agent is essential for circumventing the cross-origin resource sharing (CORS) restrictions imposed by web browsers. Apidog offers two primary options for sending API requests: the Cloud Agent and the Browser Agent.
You can utilize the Cloud Agent to send various types of API requests from the Apidog web app without CORS limitations. The Browser Agent is also available for sending HTTP requests. The Apidog web app can automatically choose the most suitable agent for your requests, or you can manually select an agent based on your specific needs.
Apidog suggests installing the desktop client for the most comprehensive experience. The Apidog desktop app provides full functionality with no restrictions when sending requests. When using the Apidog desktop app, you don't need to select an agent.
Apidog Cloud Agent
The Cloud Agent enables API requests to originate in your web browser but routes them through Apidog's secure cloud servers. This allows the Apidog web app to bypass the CORS limitations of browsers.
With the Cloud Agent, you can send HTTP requests. However, it's important to note that because the Cloud Agent uses Apidog's cloud servers, it cannot access private or local resources on your network when sending requests.
Apidog Browser Agent
You can use the Browser Agent to send HTTP requests directly from your web browser. However, you may encounter CORS limitations when using the Browser Agent.
Comparing Apidog Agents
To have Apidog automatically select the optimal agent for sending requests, choose the Auto-select option. Alternatively, use the following table to help you choose the best agent for your needs:
| Apidog Agent | Description |
|---|---|
| Cloud Agent | ✓ Avoids CORS issues ✓ No installation required ✓ Send HTTP requests ✓ Can't access private or local network resources ✓ Usage limits based on your Apidog plan |
| Browser Agent | ✓ Installation required ✓ Send HTTP requests only ✓ May encounter CORS issues when sending requests |
Selecting an Apidog Agent for Requests
In the Apidog web app, select Auto-select agent, Cloud Agent, or Browser Agent from the Apidog footer.
Choose the agent you want to use for sending requests:
Enable Auto-select to have Apidog automatically choose the best available agent. Apidog selects agents in the following order: Cloud and Browser.
Disable Auto-select and manually select the agent you prefer:
- Cloud Agent: Send HTTP requests using Apidog's cloud servers.
- Browser Extensions: Send HTTP requests using your browser, with potential CORS limitations.
After selecting an agent, send your request and view the response in the workbench.
If your request is unsuccessful because the optimal agent isn't selected, you can use the provided link in the response area to switch to the recommended agent and resend your request.