Time-out- en netwerkproblemen - Helpcentrum

Netwerkproblemen kunnen ervoor zorgen dat API-aanvragen mislukken. Zo ga je op een soepele manier om met time-outs en verbindingsproblemen.

Passende time-outs instellen

Stel altijd time-outs in om te voorkomen dat aanvragen blijven hangen:

// JavaScript met fetch
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), 30000); // 30s
try {
  const response = await fetch('https://api.cathopic.com/resources', {
    method: 'POST',
    headers: {
      'x-api-key': apiKey,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ query: 'Jesus' }),
    signal: controller.signal
  });
  
  clearTimeout(timeout);
  return await response.json();
  
} catch (error) {
  clearTimeout(timeout);
  
  if (error.name === 'AbortError') {
    console.error('Aanvraag time-out na 30s');
  } else {
    console.error('Netwerkfout:', error);
  }
  throw error;
}

// Python met requests
import requests
from requests.exceptions import Timeout, RequestException
try:
    response = requests.post(
        'https://api.cathopic.com/resources',
        headers={'x-api-key': api_key},
        json={'query': 'Jesus'},
        timeout=30  # 30 seconden
    )
    return response.json()
    
except Timeout:
    print('Aanvraag time-out na 30s')
    raise
except RequestException as e:
    print(f'Netwerkfout: {e}')
    raise

Veelvoorkomende netwerkfouten

Verbindings-time-out:

Kan geen verbinding met de server tot stand brengen
Meestal een probleem met het netwerk of de firewall
Controleer je internetverbinding
Controleer of de firewall HTTPS toestaat naar api.cathopic.com

Leestime-out:

Verbinding tot stand gebracht, maar geen respons
De server kan traag zijn of overbelast
Verhoog de time-out of probeer later opnieuw

Fout bij DNS-resolutie:

Kan api.cathopic.com niet omzetten
Probleem met de DNS-server
Probeer opnieuw of controleer de DNS-instellingen

Opnieuw proberen met backoff

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      const controller = new AbortController();
      const timeout = setTimeout(() => controller.abort(), 30000);
      
      const response = await fetch(url, {
        ...options,
        signal: controller.signal
      });
      
      clearTimeout(timeout);
      
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
      }
      
      return await response.json();
      
    } catch (error) {
      const isLastAttempt = attempt === maxRetries - 1;
      if (isLastAttempt) {
        console.error(`Alle ${maxRetries} pogingen mislukt`);
        throw error;
      }
      
      const waitTime = Math.pow(2, attempt) * 1000;
      console.log(`Poging ${attempt + 1} mislukt. Opnieuw proberen over ${waitTime}ms...`);
      
      await new Promise(resolve => setTimeout(resolve, waitTime));
    }
  }
}

Aanbevolen time-outwaarden

Verbindings-time-out: 10 seconden
Leestime-out: 30 seconden
/resources zoeken: 30 seconden
/confirm licensing: 30 seconden

Netwerkproblemen debuggen

Gebruik curl om de connectiviteit te testen:

# Test basisconnectiviteit
curl -v https://api.cathopic.com/resources
# Test met time-out
curl --max-time 30 -X POST https://api.cathopic.com/resources \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "test"}'

Controleer op:

✓ DNS lost api.cathopic.com op
✓ SSL/TLS-verbinding slaagt
✓ HTTP-respons ontvangen
✓ Responstijd redelijk (<5s doorgaans)

Als de problemen blijven, neem contact op met support met netwerkdiagnosegegevens.