GetReal Labs - WordPress API Endpoint Fix

Date: 2025-11-07 Status: ✅ FIXED Issue: 404 Error when fetching task JSON URLs

Problem

The application was returning a 404 error when trying to fetch task JSON URLs from the WordPress REST API:

Error: Failed to get JSON URLs: 404

Root Cause

The wordpress.ts API client was using incorrect endpoint URLs. The implementation was using the generic ypai/v1 namespace instead of the correct ypai-video/v1 namespace from the YPAI Video Uploader Plugin v1.2.0.

Wrong Endpoints:

• /wp-json/ypai/v1/json-urls ❌
• /wp-json/ypai/v1/upload-urls ❌
• /wp-json/ypai/v1/verify-uploads ❌

Correct Endpoints:

• /wp-json/ypai-video/v1/task-json-urls ✅
• /wp-json/ypai-video/v1/upload-urls ✅
• /wp-json/ypai-video/v1/verify-uploads ✅

Changes Applied

1. WordPress API Client (src/api/getreal/wordpress.ts)

Fixed three endpoint URLs:

Line 17 - getTaskJsonUrls():

// BEFORE (wrong)
const url = `${getBaseUrl()}/wp-json/ypai/v1/json-urls?participant_id=${encodeURIComponent(
  participantId
)}&secret=${encodeURIComponent(SECRET)}`;

// AFTER (correct)
const url = `${getBaseUrl()}/wp-json/ypai-video/v1/task-json-urls?participant_id=${encodeURIComponent(
  participantId
)}&secret=${encodeURIComponent(SECRET)}`;

Line 38 - getUploadUrls():

// BEFORE (wrong)
const url = `${getBaseUrl()}/wp-json/ypai/v1/upload-urls?secret=${encodeURIComponent(SECRET)}`;

// AFTER (correct)
const url = `${getBaseUrl()}/wp-json/ypai-video/v1/upload-urls?secret=${encodeURIComponent(SECRET)}`;

Line 64 - verifyUploads():

// BEFORE (wrong)
const url = `${getBaseUrl()}/wp-json/ypai/v1/verify-uploads?secret=${encodeURIComponent(SECRET)}`;

// AFTER (correct)
const url = `${getBaseUrl()}/wp-json/ypai-video/v1/verify-uploads?secret=${encodeURIComponent(SECRET)}`;

2. Configuration File (src/config/getreal.config.ts)

Updated endpoint documentation:

wordpress: {
  baseUrl: 'https://yourpersonalai.net',
  endpoints: {
    taskJsonUrls: '/wp-json/ypai-video/v1/task-json-urls',  // ← Updated
    uploadUrls: '/wp-json/ypai-video/v1/upload-urls',        // ← Updated
    verifyUploads: '/wp-json/ypai-video/v1/verify-uploads',  // ← Updated
  },
},

3. README (src/pages/getreal/README.md)

Updated API documentation section to reflect correct endpoints and plugin version:

Endpoints (YPAI Video Uploader Plugin v1.2.0):
- `/wp-json/ypai-video/v1/task-json-urls?participant_id={id}` - Get task JSON URLs
- `/wp-json/ypai-video/v1/upload-urls` - Get presigned S3 upload URLs
- `/wp-json/ypai-video/v1/verify-uploads` - Verify all uploads complete

4. Implementation Complete Doc (src/pages/getreal/IMPLEMENTATION-COMPLETE.md)

Marked WordPress endpoints as fixed and updated documentation.

WordPress Plugin Details

Plugin Name: YPAI Video Uploader Version: v1.2.0 Namespace: ypai-video/v1

Endpoints Overview

1. GET /wp-json/ypai-video/v1/task-json-urls

   • Purpose: Get presigned S3 URLs for task JSON files
   • Parameters:
     • participant_id (required)
     • secret (required)
   • Returns: Array of 10 JSON URLs

2. POST /wp-json/ypai-video/v1/upload-urls

   • Purpose: Get presigned S3 URLs for video uploads
   • Parameters:
     • secret (required, query param)
   • Body:

     {
       "participant_id": "01234",
       "files": [
         {
           "task_uuid": "uuid-here",
           "file_name": "video.webm",
           "content_type": "video/webm"
         }
       ]
     }
     

   • Returns: Array of presigned upload URLs

3. POST /wp-json/ypai-video/v1/verify-uploads

   • Purpose: Verify all uploads completed and get completion URL
   • Parameters:
     • secret (required, query param)
   • Body:

     {
       "participant_id": "01234",
       "uploaded_videos": [
         {
           "task_uuid": "uuid-here",
           "uploaded_at": "2025-11-07T12:00:00.000Z"
         }
       ],
       "source": "Prolific",
       "prolific_pid": "ABC123"
     }
     

   • Returns:

     {
       "success": true,
       "completion_url": "https://prolific.co/..."
     }
     

Testing

Dev Server Status

✅ Dev server running on http://localhost:4065/

Pages Status

• ✅ /getreal/camera-test - Camera validation page
• ✅ /getreal/consent - Typeform consent form
• ✅ /getreal/record - Recording interface (now with correct API endpoints)

Next Steps for Testing

1. Test with Real Participant ID:

   http://localhost:4065/getreal/record?participant_id=01234&session_id=test-session&source=Prolific
   

2. Verify API Calls:

   • Open browser console
   • Navigate to record page
   • Check Network tab for API calls
   • Should see successful responses from /wp-json/ypai-video/v1/task-json-urls

3. Test Full Flow:

   • Camera test → Consent → Recording
   • Record a test video
   • Verify upload completes
   • Check WordPress receives upload notification

Source of Truth

Documentation: T:\Obsidian\YPAI\Clients\GetReal Labs\Gesture Data Collection\Gesture Data Collection.md

This Obsidian document contains the complete WordPress plugin documentation including:

• REST API endpoints
• Request/response formats
• Participant folder range (1201-1600)
• Quality settings (1080p @ 30fps @ 10 Mbps)
• Source-aware completion logic (Prolific vs Recruitee)

Impact

✅ Resolved: 404 errors when fetching task JSON URLs ✅ Benefit: Application can now communicate with WordPress REST API ✅ Next: Ready for end-to-end participant flow testing

Fix Applied: 2025-11-07 Files Modified: 4 (wordpress.ts, getreal.config.ts, README.md, IMPLEMENTATION-COMPLETE.md) Lines Changed: 12 lines across 4 files