Set Up a Test API Call
This step defines a test API operation to validate that the authentication and request logic is working correctly. The test is triggered when a connector is created using this integration.
Step 3: Test Configuration
- Choose a lightweight, non-destructive API endpoint from the third-party platform that can confirm successful connectivity.
| Config Section | Developer Action | Example |
|---|---|---|
| HTTP Method | Select the request method to test connectivity. | GET |
| Test URL | Provide the full API endpoint. Use one that verifies credentials without modifying data. | https://sellingpartnerapi-na.amazon.com/orders/v0/orders |
| Headers / Auth | Add required headers (e.g., token, API key) as expected by the platform. | Authorization: Bearer ${access_token} |
| Params / Body | Add optional query parameters or body values. | Filter fields, date ranges, etc. |
| Assert Expression | Define the expected success condition. | HTTP Status Code == 200 |
| Output Processing | Select how the response will be handled or extracted. | - Path: $.order_id - Fixed: token_type: Bearer - Full Response |
- After completing the fields above, click Save and Next.
- To execute the test API operation and validate the configuration:
a. Navigate to Workspace and select the target merchant. b. Click + Add Connector. c. From the connector list, choose the integration created in Step 1. d. Input required authentication fields (e.g., API Key, OAuth login). e. Complete the auth flow and click Test Connection. f. This triggers both:- Authentication check (token or credential validation)
- Execution of the configured test API call
- If the connection is successful, click Submit. The connector will now appear in the Connectors list.
- If the test fails:
a. Review the Error Message in the connector setup window.
b. Navigate to Integrations, locate the one you created, and click View Logs (opens in a new tab) for debugging.