Foutcodes & statusreferentie

Uitgebreide handleiding voor Smart Money API-foutcodes, HTTP-statuscodes en probleemoplossingsstappen. Begrijp foutreacties en los integratieproblemen snel op.

2xx Succescodes

Succesreacties geven aan dat het verzoek succesvol is verwerkt.

Code	Status	Betekenis
200	OK	Verzoek geslaagd. Reactiebody bevat de gevraagde gegevens.
201	Created	Bron is succesvol aangemaakt. Reactie bevat de nieuwe bron.
204	No Content	Verzoek geslaagd maar er is geen inhoud om terug te sturen (bijv. DELETE).

Voorbeeld 200 Reactie

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

4xx Clientfoutcodes

Clientfouten geven aan dat het verzoek onjuist of ongeldig was. Corrigeer je verzoek en probeer het opnieuw.

Code	Status	Oorzaak
400	Bad Request	Onjuiste verzoeksyntaxis. Controleer queryparameters, headers en verzoekbody.
401	Unauthorized	Ontbrekende of ongeldige authenticatiegegevens. Controleer je API-sleutel of JWT-token.
402	Payment Required	Je abonnementsbetaling is mislukt. Werk de factuurgegevens in je account bij.
403	Forbidden	Geauthenticeerd maar niet geautoriseerd voor deze bron. Je abonnement bevat deze functie niet.
404	Not Found	Bron bestaat niet. Controleer de eindpunt-URL en parameters.
429	Too Many Requests	Snelheidslimiet overschreden. Wacht voordat je het opnieuw probeert. Controleer de Retry-After header.
422	Unprocessable Entity	Validatie mislukt. Verzoekparameters zijn ongeldig of ontbreken vereiste velden.

Voorbeelden van authenticatiefouten

Ontbrekende API-sleutel (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Authenticatiegegevens niet opgegeven.",
    "resolution": "Voeg je API-sleutel toe in de Authorization-header: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ongeldige API-sleutel (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Ongeldige of verlopen API-sleutel.",
    "resolution": "Genereer een nieuwe API-sleutel vanuit je console op https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Snelheidsbeperking (429)

Wanneer je je API-quota overschrijdt, retourneert de server 429 Too Many Requests. Controleer de reactieheaders voor informatie over de snelheidslimiet:

HTTP-headers

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Foutreactie snelheidslimiet

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Dagelijkse API-verzoeklimiet (10) overschreden.",
    "resolution": "Upgrade naar Trader ($29/maand, 400 verzoeken/dag) of Pro ($79/maand, 4.000 verzoeken/dag) abonnement.",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Validatiefouten (422)

Validatiefouten treden op wanneer je verzoekparameters ongeldig zijn of vereiste velden ontbreken.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Verzoekvalidatie mislukt.",
    "details": [
      {
        "field": "symbol",
        "error": "Ongeldig handelspaar. Verwacht formaat: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Moet een positief getal zijn"
      }
    ],
    "resolution": "Los de validatiefouten op en probeer het opnieuw."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

5xx Serverfoutcodes

Serverfouten duiden op een probleem aan onze kant. Deze zijn tijdelijk en worden meestal snel opgelost. Implementeer exponentieel uitstel voor opnieuw proberen.

Code	Status	Actie
500	Internal Error	Onverwachte serverfout. Probeer opnieuw met exponentieel uitstel.
502	Bad Gateway	Tijdelijke serviceonderbreking. Probeer het na een paar seconden opnieuw.
503	Service Unavailable	Onderhoud of tijdelijke storing. Controleer de statuspagina. Probeer het opnieuw na het Retry-After interval.
504	Gateway Timeout	Verzoek duurde te lang. De server heeft het mogelijk toch verwerkt. Controleer idempotentie.

Voorbeeld serverfout (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Service tijdelijk niet beschikbaar vanwege onderhoud.",
    "resolution": "Probeer het over 5 minuten opnieuw. Volg de status op https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Probleemoplossingsgids

401 Unauthorized - Ongeldige API-sleutel

Probleem: Ontvangst van 401-fouten ondanks een API-sleutel.

Oplossingen:

Controleer of de API-sleutel is opgenomen in de Authorization-header met "Bearer"-voorvoegsel
Controleer of je API-sleutel niet is verlopen of ingetrokken
Zorg ervoor dat je de juiste sleutel gebruikt (productie, staging of ontwikkeling)
Genereer een nieuwe API-sleutel vanuit je console als de huidige verloren is

403 Forbidden - Functie niet beschikbaar

Probleem: Ontvangst van 403-fouten op bepaalde eindpunten.

Oplossingen:

Controleer je API-tier. Sommige eindpunten vereisen Trader- of Pro-abonnementen
Upgrade je abonnement op /pricing.html om toegang te krijgen tot premiumfuncties
Controleer of de API-sleutel de vereiste scopes heeft ingeschakeld
Neem contact op met ondersteuning als je denkt dat je toegang zou moeten hebben

429 Too Many Requests - Snelheidsbeperking

Probleem: Ontvangst van 429-fouten en snelheidsbeperking.

Oplossingen:

Implementeer exponentieel uitstel voor opnieuw proberen (wacht 1s, 2s, 4s, etc.)
Cache reacties om overbodige API-aanroepen te voorkomen
Gebruik WebSocket voor realtime gegevens in plaats van REST-eindpunten te pollen
Upgrade je abonnement voor hogere quota (Trader 1,000/dag, Pro 5.000/dag)
Combineer meerdere query's in enkele verzoeken waar mogelijk

400 Bad Request - Ongeldige parameters

Probleem: Ontvangst van 400-fouten met onjuiste verzoeken.

Oplossingen:

Controleer de API-documentatie voor vereiste en optionele parameters
Controleer parametertypen (strings vs nummers, arrays vs objecten)
Zorg ervoor dat JSON geldig en correct geformatteerd is
Gebruik de juiste eindpunt-URL's met de juiste padparameters
Controleer op typefouten in queryparameternamen

5xx Serverfouten - Tijdelijke storingen

Probleem: Krijg je 500, 502, 503 of 504 foutmeldingen.

Oplossingen:

Controleer de servicestatus op https://status.smartmoneyapi.com
Implementeer automatische herpogingen met exponentieel terugtrekken (max 5-10 pogingen)
Wacht 30-60 seconden voordat je 503-fouten opnieuw probeert
Gebruik de Retry-After header om het tijdstip voor herpogingen te bepalen
Abonneer je op de statuspagina voor incidentmeldingen

Foutresponsformaat

Alle foutresponses volgen een consistent formaat:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Leesbare foutmelding",
    "details": {...},
    "resolution": "Stappen om het probleem op te lossen"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Meer hulp nodig?

Bekijk onze API-documentatie of neem contact op met de ondersteuning met je foutcode en verzoekdetails.

API-referentie

Ondersteuning krijgen

Heb je vragen? Bekijk onze documentatie of neem contact op met de ondersteuning.

Console openen