Settings Reference

Complete reference of all configuration options in API Mapper.

Global Settings

License

License Key: Your API Mapper license key
Status: Shows current license status and tier

Defaults

Default Cache Duration: Default cache time for new connections (in seconds)
Debug Mode: Enable verbose logging for troubleshooting

Connection Settings

Basic Settings

Setting	Description	Required
Name	Display name for the connection	Yes
Base URL	Root URL of the API	Yes
Description	Notes about the connection	No
Enabled	Whether the connection is active	Yes

Request Settings

Setting	Description	Default
Endpoint	Path to the API resource	-
Method	HTTP method (GET, POST, etc.)	GET
Timeout	Request timeout in seconds	30

Query Parameters

Add URL parameters that will be appended to requests:

Field	Description
Name	Parameter name
Value	Parameter value

Example: ?per_page=10&status=active

Headers

Custom HTTP headers to send with requests:

Field	Description
Name	Header name
Value	Header value

Example: Accept: application/json

Authentication

Type	Fields	Use Case
None	-	Public APIs
API Key	Location, Name, Key	Most APIs
Bearer Token	Token	OAuth2, JWT
Basic Auth	Username, Password	Legacy APIs

Field Mapping

Setting	Description
Name	Display name in YOOtheme
Path	JSON path to the data
Type	Data type (Text, Number, etc.)

Available Types:

text - String values
number - Numeric values
image - Image URLs
link - Hyperlinks
date - Date/time values
boolean - True/false values

Caching

Setting	Description	Default
Enable Cache	Whether to cache responses	Yes
Cache Duration	Time to cache in seconds	3600
Cache Key	Custom cache identifier	Auto

PHP Constants

WordPress

Override settings via wp-config.php:

// Disable caching globally
define('API_MAPPER_DISABLE_CACHE', true);
 
// Set default timeout
define('API_MAPPER_DEFAULT_TIMEOUT', 60);
 
// Enable debug mode
define('API_MAPPER_DEBUG', true);

Hooks & Events

WordPress

Filters

// Modify request before sending
add_filter('api_mapper_request', function($request, $connection) {
    // Modify $request
    return $request;
}, 10, 2);
 
// Modify response after receiving
add_filter('api_mapper_response', function($response, $connection) {
    // Modify $response
    return $response;
}, 10, 2);
 
// Modify cache duration
add_filter('api_mapper_cache_duration', function($duration, $connection) {
    return $duration;
}, 10, 2);

Actions

// After successful request
do_action('api_mapper_after_request', $response, $connection);
 
// On request error
do_action('api_mapper_request_error', $error, $connection);
 
// When cache is cleared
do_action('api_mapper_cache_cleared', $connection_id);

Environment Variables

For containerized deployments:

API_MAPPER_LICENSE_KEY=your-license-key
API_MAPPER_DEBUG=false
API_MAPPER_CACHE_DRIVER=redis

File Locations

WordPress

Settings: wp_options table (api_mapper_settings)
Connections: wp_options table (api_mapper_connections)
Cache: WordPress Transients API

Settings Reference

On this page