User Validation Tool

Purpose: Bind traffic events to user IDs for account-level security

Integration: Backend API calls with session binding

⚙️ Setup & Configuration

Authentication: All API endpoints require Bearer token authentication using your secret key. Include it in the Authorization header as Bearer YOUR_SECRET_KEY.

Frontend Integration

// Get the session ID from localStorage
const taSessionId = window.localStorage.getItem('ta_session_id');

// Example: Add to a signup form
const signupForm = document.getElementById('signup-form');
signupForm.addEventListener('submit', async (e) => {
  e.preventDefault();
  
  const formData = new FormData(signupForm);
  formData.append('ta_session_id', taSessionId);
  
  // Send to your backend
  const response = await fetch('/api/signup', {
    method: 'POST',
    body: formData
  });
});

Backend Integration

// Example with Axios
const bindUserToTraffic = async (userId, taSessionId) => {
  try {
    const response = await axios.post(
      `https://api.trustedaccounts.org/api/v1/traffic/bind`,
      {
        trustedSessionId: taSessionId,
        userId: userId
      },
      { 
        headers: { 
          'Authorization': `Bearer ${SECRET_KEY}`,
          'Content-Type': 'application/json' 
        } 
      }
    );
    
    if (response.status === 204) {
      console.log('User successfully bound to traffic');
      return true;
    }
  } catch (error) {
    console.error('Failed to bind user:', error.response?.data || error.message);
    return false;
  }
};

📈 Logs & Charts

Success Rate Analysis

• Binding Success: Percentage of successful bindings
• Error Analysis: Common failure reasons
• Signup Timing: When users create accounts

🚨 Troubleshooting

Common Issues

• Session ID Not Found: Check Bot Detection implementation
• Binding Fails: Verify API credentials and format
• No Validation Data: Wait for traffic accumulation
• Performance Issues: Check API response times

Health Checks

// Check service health
const checkHealth = async () => {
  try {
    const response = await fetch('https://developers.trustedaccounts.org/health');
    const health = await response.json();
    console.log('Service Health:', health);
    return health.status === 'healthy';
  } catch (error) {
    console.error('Health Check Failed:', error);
    return false;
  }
};

---

Pro Tip: Start with immediate binding on signup and gradually add more sophisticated strategies as your system matures. Monitor error rates to ensure reliable operation.