Troubleshooting Guide

This guide helps you diagnose and resolve common issues when working with the Unified Commerce Platform API.

Connection Issues

Problem: Cannot connect to the API

Symptoms:

• Connection timeout errors
• DNS resolution failures
• SSL/TLS handshake errors

Solutions:

1. Verify the endpoint URL:

   // Correct endpoint
   const ENDPOINT = 'https://gateway.unifiedcommerce.app/graphql';
   

2. Check network connectivity:

   curl -I https://gateway.unifiedcommerce.app/graphql
   

Authentication Problems

Problem: 401 Unauthorized Errors

Symptoms:

• "Invalid API key"
• "Authentication required"
• "Token expired"

Solutions:

1. Verify API key format:

   const headers = {
     'Authorization': 'Bearer uc_live_sk_1234567890abcdef'
   };
   

Need Help?

• Discord Community - Ask questions
• Support - Technical support