API Introduction

https://api.goblue.app/v1

https://api.goblue.app/v1/forms/{form-id}/webhook

https://api.goblue.app/v1/messages/{api-key}

Authorization: Bearer {your-api-key}

Content-Type: application/json

{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "lastName": "Doe",
  "customField": "Custom data"
}

{
  "status": "success",
  "message": "Message queued successfully",
  "data": {
    "messageId": "uuid",
    "queuePosition": 1
  }
}

{
  "status": "error",
  "message": "Missing required field: phoneNumber",
  "code": "VALIDATION_ERROR",
  "details": {
    "field": "phoneNumber",
    "requirement": "Valid phone number required"
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 75
X-RateLimit-Reset: 1640995200

{
  "status": "error",
  "message": "Rate limit exceeded. Please try again later.",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 60
}

async function sendWithBackoff(url, data, attempt = 1) {
  try {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data)
    });
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After') || Math.pow(2, attempt);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return sendWithBackoff(url, data, attempt + 1);
    }
    
    return response;
  } catch (error) {
    if (attempt < 3) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      return sendWithBackoff(url, data, attempt + 1);
    }
    throw error;
  }
}

async function handleGoBlueResponse(response) {
  const data = await response.json();
  
  if (!response.ok) {
    switch (data.code) {
      case 'VALIDATION_ERROR':
        throw new Error(`Invalid data: ${data.message}`);
      case 'AUTHENTICATION_ERROR':
        throw new Error('Authentication failed - check API key');
      case 'RATE_LIMIT_EXCEEDED':
        // Implement retry with exponential backoff
        throw new Error('Rate limited - retry after delay');
      case 'FORM_DISABLED':
        throw new Error('Form capturing is disabled');
      default:
        throw new Error(`API error: ${data.message}`);
    }
  }
  
  return data;
}

{
  "appointmentTime": "2024-01-15T14:30:00Z",
  "createdAt": "2024-01-15T10:00:00-05:00"
}

# Test webhook endpoint
curl -X POST https://api.goblue.app/v1/forms/{form-id}/webhook \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","phoneNumber":"+1234567890"}'

# Test message retrieval
curl https://api.goblue.app/v1/messages/{api-key}

https://api.goblue.app/v1/

Accept: application/json
X-API-Version: v1