Features FAQ

What authentication methods are supported?

API Mapper supports the most common authentication methods:

Not yet supported:

• OAuth2 with browser redirect
• Client certificates
• Custom signature schemes (like AWS Signature)

What is JMESPath?

JMESPath is a query language for JSON. It allows you to:

• Transform API responses
• Filter data
• Rename fields
• Calculate values

Example: Extract just the product names from a nested response:

products[*].name

JMESPath is available in Pro and Developer licenses.

Can I filter or sort API data?

Yes, in multiple ways:

1. At the API level: Use query parameters (e.g., ?status=published&orderby=date)
2. With JMESPath: Filter and sort in API Mapper (Pro/Developer)
3. In YOOtheme: Use YOOtheme's built-in filtering options

Can I combine data from multiple APIs?

Currently, each connection is independent. To combine data:

• Create separate connections for each API
• Use YOOtheme's layout options to display them together
• Use JMESPath to restructure data within a single connection

Does API Mapper support pagination?

API Mapper fetches data as configured in your endpoint. For pagination:

• Use query parameters like ?page=1&per_page=10
• Create multiple connections for different pages
• Or configure the API to return all needed data at once

Automatic pagination handling is planned for a future release.

Can I use POST requests?

Yes! API Mapper supports:

• GET (most common)
• POST
• PUT
• PATCH
• DELETE

For POST/PUT/PATCH, you can configure the request body in JSON format.

Can I use dynamic values in API requests?

Currently, API parameters are static (configured once). Dynamic parameters based on user input or page context are planned for a future release.

Workaround: Create multiple connections with different parameters and switch between them in YOOtheme.

What data types are supported?

API Mapper can map these field types:

• Text - Strings, formatted text
• Number - Integers, decimals
• Image - Image URLs
• Link - Hyperlinks
• Date - Date/time values
• Boolean - True/false values

Can I access nested data?

Yes! Use dot notation or bracket notation:

• user.profile.name
• items[0].title
• data.products[*].price

JMESPath (Pro/Developer) offers even more powerful nested data access.