API Version Compatibility

Quick Version Check

Not sure which version you have? Check in: WordPress Admin → Plugins → QA Platform

Or call the /guide endpoint to see your plugin_version.

---

Compatibility Matrix

Plugin Version	Compatible API Versions	Status	Notes
3.0.0.0+	2025-10-20	✅ Current	Full feature support
2.x.x.x	-	❌ Unsupported	API not available

---

Version 2025-10-20

Minimum Plugin Version: 3.0.0.0
Released: 2025-10-20
Status: Current Release

Plugin Requirements

Feature	Min Plugin Version	Notes
Core API	3.0.0.0	Base functionality
tracking_id parameter	3.0.0.0	Required for all queries
/guide endpoint (full)	3.0.0.0	Server info, sites, materials, goals
/query endpoint	3.0.0.0	QAL query execution

Material Support

Material	Min Plugin Version	Feature Set
allpv	3.0.0.0	Full column set
gsc	3.0.0.0	Full column set

---

Checking Your Plugin Version

Method 1: WordPress Admin

1. Go to Plugins page
2. Find QA Platform
3. Version shown below plugin name

Method 2: API Call

curl -u "username:password" \
  "https://your-site.com/wp-json/qa-platform/guide?version=2025-10-20"

Response includes:

{
  "version": "2025-10-20",
  "plugin_version": "3.0.0.0",
  ...
}

---

Feature Availability by Plugin Version

Plugin 3.0.0.0

New in This Version:

• ✅ REST API support (2025-10-20)
• ✅ Multi-site tracking with tracking_id
• ✅ Enhanced /guide endpoint
• ✅ QAL query language
• ✅ Materials: allpv, gsc

Field Changes:

• 🔄 country → country_code (ISO 3166-1 alpha-2)
• ❌ Removed: session_id, tracking_domain, path_prefix, utm_content, utm_term, version_id
• ❌ Removed: All goal fields (is_goal_0 through is_goal_10, is_submit)

---

Migration Guide

From Pre-API Versions (< 3.0)

If you're upgrading from earlier plugin versions:

1. Update Plugin: Upgrade to 3.0.0.0+
2. Get tracking_id: Call /guide endpoint
3. Update Integrations: Add tracking_id to all queries
4. Field Changes: Update country to country_code
5. Test: Verify queries work with new API

Breaking Changes:

• API endpoints did not exist before 3.0.0.0
• If you had custom integrations, they need complete rewrite

---

Future Versions

Planned Features (Future Plugin Versions)

Features currently under consideration:

• Advanced filtering (filter in QAL)
• Material joins (join in QAL)
• Aggregations (calc in QAL)
• Additional materials (clicks, ec, inner_search)
• CSV/Parquet export formats

Release dates and versions TBD

---

Support Policy

Long-Term Support

• Minimum Support Period: 24 months from release
• API Version 2025-10-20: Supported until at least 2027-10-20

Plugin Version Support

• Latest Version: Full support
• One Version Back: Security updates only
• Older Versions: No support

Current Support Status:

• 3.0.0.0: ✅ Full support

---

Troubleshooting

"Unknown tracking_id" Error

Cause: Plugin version < 3.0.0.0
Solution: Upgrade to 3.0.0.0+

"Endpoint not found" Error

Cause: Plugin version < 3.0.0.0
Solution: Upgrade to 3.0.0.0+

Missing Materials or Fields

Cause: Plugin version too old
Solution: Check compatibility matrix above and upgrade

---

Getting Help

• Documentation: Version 2025-10-20
• Plugin Updates: Check WordPress plugin repository
• Support: Contact your system administrator

---

Version History

Plugin Version	API Versions	Release Date	Status
3.0.0.0	2025-10-20	2025-10-20	Current

---

Next Steps

• Getting Started with 2025-10-20 - Start using the API
• Version Management - How we version the API