Felkoder & statusreferens
Omfattande guide för Smart Money API:s felkoder, HTTP-statuskoder och felsökningssteg. Förstå felsvar och lös integrationsproblem snabbt.
2xx Lyckade koder
Lyckade svar indikerar att förfrågan behandlades framgångsrikt.
| Kod | Status | Betydelse |
|---|---|---|
| 200 | OK | Förfrågan lyckades. Svarskroppen innehåller begärda data. |
| 201 | Skapad | Resursen skapades framgångsrikt. Svaret inkluderar den nya resursen. |
| 204 | Inget innehåll | Förfrågan lyckades men det finns inget innehåll att returnera (t.ex. DELETE). |
Exempel på 200-svar
JSON
{
"success": true,
"data": {
"total": 42,
"positions": [...],
"pagination": {
"page": 1,
"limit": 50
}
},
"timestamp": "2026-03-21T14:35:22Z"
}
4xx Klientfelkoder
Klientfel indikerar att förfrågan var felaktigt formulerad eller ogiltig. Åtgärda din förfrågan och försök igen.
| Kod | Status | Orsak |
|---|---|---|
| 400 | Felaktig förfrågan | Felaktig förfrågesyntax. Kontrollera frågeparametrar, rubriker och förfrågans kropp. |
| 401 | Obehörig | Saknade eller ogiltiga autentiseringsuppgifter. Kontrollera din API-nyckel eller JWT-token. |
| 402 | Betalning krävs | Din prenumerationsbetalning misslyckades. Uppdatera faktureringsinformation i ditt konto. |
| 403 | Förbjuden | Autentiserad men inte behörig för denna resurs. Din plan inkluderar inte denna funktion. |
| 404 | Hittades inte | Resursen existerar inte. Kontrollera slutpunkts-URL:en och parametrar. |
| 429 | För många förfrågningar | Begränsning av förfrågningar överskriden. Vänta innan du försöker igen. Kontrollera Retry-After-rubriken. |
| 422 | Obehandlingsbar enhet | Validering misslyckades. Förfrågeparametrar är ogiltiga eller saknar obligatoriska fält. |
Exempel på autentiseringsfel
Saknad API-nyckel (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_MISSING_KEY",
"message": "Autentiseringsuppgifter saknas.",
"resolution": "Inkludera din API-nyckel i Authorization-rubriken: Authorization: Bearer sk_live_..."
},
"timestamp": "2026-03-21T14:35:22Z"
}
Ogiltig API-nyckel (401)
JSON
{
"success": false,
"error": {
"code": "AUTH_INVALID_KEY",
"message": "Ogiltig eller utgången API-nyckel.",
"resolution": "Skapa en ny API-nyckel från din konsol på https://smartmoneyapi.com/console"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Begränsning av förfrågningar (429)
När du överskrider din API-kvot returnerar servern 429 För många förfrågningar. Kontrollera svarsrubrikerna för information om begränsningen:
HTTP-rubriker
X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600
Felmeddelande vid begränsning av förfrågningar
JSON
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Daglig API-förfrågegräns (10) överskriden.",
"resolution": "Uppgradera till Trader ($29/månad, 400 förfrågningar/dag) eller Pro ($79/månad, 4 000 förfrågningar/dag) plan.",
"reset_at": "2026-03-22T09:00:00Z"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Valideringsfel (422)
Valideringsfel uppstår när dina förfrågeparametrar är ogiltiga eller saknar obligatoriska fält.
JSON
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Förfrågevalidering misslyckades.",
"details": [
{
"field": "symbol",
"error": "Ogiltigt handelspar. Förväntat format: BTCUSDT"
},
{
"field": "min_position_size",
"error": "Måste vara ett positivt tal"
}
],
"resolution": "Åtgärda valideringsfelen och försök igen."
},
"timestamp": "2026-03-21T14:35:22Z"
}
5xx Serverfelkoder
Serverfel indikerar ett problem på vår sida. Dessa är tillfälliga och löser sig vanligtvis snabbt. Implementera exponentiell backoff-logik för återförsök.
| Kod | Status | Åtgärd |
|---|---|---|
| 500 | Internt fel | Oväntat serverfel. Försök igen med exponentiell backoff. |
| 502 | Felaktig gateway | Tillfällig avbrott i tjänsten. Försök igen efter några sekunder. |
| 503 | Tjänsten är inte tillgänglig | Underhåll eller tillfälligt avbrott. Kontrollera statussidan. Försök igen efter Retry-After-intervallet. |
| 504 | Gateway-timeout | Förfrågan tog för lång tid. Servern kan ha behandlat den ändå. Kontrollera idempotens. |
Exempel på serverfel (503)
JSON
{
"success": false,
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Tjänsten är tillfälligt otillgänglig på grund av underhåll.",
"resolution": "Försök igen efter 5 minuter. Följ status på https://status.smartmoneyapi.com"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Felsökningsguide
401 Obehörig - Ogiltig API-nyckel
Problem: Får 401-fel trots API-nyckel.
Lösningar:
- Verifiera att API-nyckeln ingår i Authorization-rubriken med "Bearer"-prefix
- Kontrollera att din API-nyckel inte har gått ut eller blivit återkallad
- Se till att du använder rätt nyckel (produktion, staging eller utveckling)
- Skapa en ny API-nyckel från din konsol om den nuvarande är förlorad
403 Förbjuden - Funktion inte tillgänglig
Problem: Får 403-fel på vissa slutpunkter.
Lösningar:
- Kontrollera din API-nivå. Vissa slutpunkter kräver Trader- eller Pro-planer
- Uppgradera din plan på /pricing.html för att få tillgång till premiumfunktioner
- Verifiera att API-nyckeln har nödvändiga scope aktiverade
- Kontakta support om du tror att du borde ha tillgång
429 För många förfrågningar - Begränsad
Problem: Får 429-fel och är begränsad.
Lösningar:
- Implementera exponentiell backoff-logik för återförsök (vänta 1s, 2s, 4s, etc.)
- Cacha svar för att undvika onödiga API-anrop
- Använd WebSocket för realtidsdata istället för att polla REST-slutpunkter
- Uppgradera din plan för högre kvoter (Trader 1,000/dag, Pro 5 000/dag)
- Samla flera frågor till enkel förfrågan där möjligt
400 Felaktig förfrågan - Ogiltiga parametrar
Problem: Får 400-fel med felaktiga förfrågningar.
Lösningar:
- Kontrollera API-dokumentationen för obligatoriska och valfria parametrar
- Verifiera parametertyper (strängar vs siffror, arrayer vs objekt)
- Se till att JSON är giltig och korrekt formaterad
- Använd korrekta slutpunkts-URL:er med rätt sökvägsparametrar
- Kontrollera stavfel i frågeparameternamn
5xx Serverfel - Tillfälliga avbrott
Problem: Får 500, 502, 503 eller 504 fel.
Lösningar:
- Kontrollera tjänstestatus på https://status.smartmoneyapi.com
- Implementera automatisk återförsök med exponentiell backoff (max 5-10 försök)
- Vänta 30-60 sekunder innan du försöker igen vid 503 fel
- Använd Retry-After-huvudet för att bestämma återförsökstid
- Prenumerera på statussidan för incidentmeddelanden
Felresponsformat
Alla felresponser följer ett konsekvent format:
JSON
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"details": {...},
"resolution": "Steps to resolve the issue"
},
"timestamp": "2026-03-21T14:35:22Z"
}
Behöver du mer hjälp?
Kolla vår API-dokumentation eller kontakta support med ditt felkod och förfrågningsdetaljer.
API-referens