Coduri de eroare și referință de stare

Ghid cuprinzător pentru codurile de eroare Smart Money API, codurile de stare HTTP și pașii de depanare. Înțelegeți răspunsurile de eroare și rezolvați rapid problemele de integrare.

Coduri de succes 2xx

Răspunsurile de succes indică faptul că cererea a fost procesată cu succes.

Cod	Stare	Semnificație
200	OK	Cerere reușită. Corpul răspunsului conține datele solicitate.
201	Creat	Resursa a fost creată cu succes. Răspunsul include noua resursă.
204	Fără conținut	Cererea a reușit, dar nu există conținut de returnat (ex., DELETE).

Exemplu de răspuns 200

JSON

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

Coduri de eroare de client 4xx

Erorile de client indică faptul că cererea a fost formatată greșit sau este invalidă. Corectați cererea și încercați din nou.

Cod	Stare	Cauză
400	Cerere greșită	Sintaxă de cerere greșită. Verificați parametrii de interogare, antetele și corpul cererii.
401	Neautorizat	Credențiale de autentificare lipsă sau invalide. Verificați cheia API sau tokenul JWT.
402	Plată necesară	Plata abonamentului dvs. a eșuat. Actualizați informațiile de facturare din contul dvs.
403	Interzis	Autentificat, dar nu autorizat pentru această resursă. Planul dvs. nu include această funcționalitate.
404	Nu a fost găsit	Resursa nu există. Verificați URL-ul endpointului și parametrii.
429	Prea multe cereri	Limita de rată a fost depășită. Așteptați înainte de a reîncerca. Verificați antetul Retry-After.
422	Entitate neprocesabilă	Validarea a eșuat. Parametrii cererii sunt invalizi sau lipsesc câmpuri obligatorii.

Exemple de erori de autentificare

Cheie API lipsă (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Credențiale de autentificare nefurnizate.",
    "resolution": "Includeți cheia API în antetul Authorization: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Cheie API invalidă (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Cheie API invalidă sau expirată.",
    "resolution": "Generați o nouă cheie API din consola dvs. la https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Limitare de rată (429)

Când depășiți cota API, serverul returnează 429 Prea multe cereri. Verificați antetele răspunsului pentru informații despre limita de rată:

Antete HTTP

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

Răspuns de eroare la limita de rată

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Limita zilnică de cereri API (10) a fost depășită.",
    "resolution": "Faceți upgrade la planul Trader ($29/lună, 400 cereri/zi) sau Pro ($79/lună, 4.000 cereri/zi).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Erori de validare (422)

Erorile de validare apar când parametrii cererii dvs. sunt invalizi sau lipsesc câmpuri obligatorii.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validarea cererii a eșuat.",
    "details": [
      {
        "field": "symbol",
        "error": "Pereche de tranzacționare invalidă. Format așteptat: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Trebuie să fie un număr pozitiv"
      }
    ],
    "resolution": "Remediați erorile de validare și încercați din nou."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Coduri de eroare de server 5xx

Erorile de server indică o problemă din partea noastră. Acestea sunt temporare și se rezolvă de obicei rapid. Implementați o logică de încercare cu backoff exponențial.

Cod	Stare	Acțiune
500	Eroare internă	Eroare neașteptată a serverului. Reîncercați cu backoff exponențial.
502	Gateway greșit	Întrerupere temporară a serviciului. Reîncercați după câteva secunde.
503	Serviciu indisponibil	Întreținere sau întrerupere temporară. Verificați pagina de stare. Reîncercați după intervalul Retry-After.
504	Timeout gateway	Cererea a durat prea mult. Este posibil ca serverul să o fi procesat oricum. Verificați idempotența.

Exemplu de eroare de server (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Serviciul este temporar indisponibil din cauza întreținerii.",
    "resolution": "Vă rugăm să reîncercați după 5 minute. Verificați starea la https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ghid de depanare

401 Neautorizat - Cheie API invalidă

Problemă: Primiți erori 401 chiar și cu o cheie API.

Soluții:

Verificați dacă cheia API este inclusă în antetul Authorization cu prefixul "Bearer"
Verificați dacă cheia API nu a expirat sau a fost revocată
Asigurați-vă că utilizați cheia corectă (producție, staging sau dezvoltare)
Generați o nouă cheie API din consola dvs. dacă cea actuală este pierdută

403 Interzis - Funcționalitate indisponibilă

Problemă: Primiți erori 403 pe anumite endpointuri.

Soluții:

Verificați nivelul API. Unele endpointuri necesită planuri Trader sau Pro
Faceți upgrade la planul dvs. la /pricing.html pentru a accesa funcționalitățile premium
Verificați dacă cheia API are scope-urile necesare activate
Contactați suportul dacă credeți că ar trebui să aveți acces

429 Prea multe cereri - Limitat de rată

Problemă: Primiți erori 429 și sunteți limitați de rată.

Soluții:

Implementați o logică de încercare cu backoff exponențial (așteptați 1s, 2s, 4s etc.)
Stocați în cache răspunsurile pentru a evita apelurile API redundante
Utilizați WebSocket pentru date în timp real în loc să interogați endpointurile REST
Faceți upgrade la planul dvs. pentru cote mai mari (Trader 1,000/zi, Pro 5.000/zi)
Combinați mai multe interogări într-o singură cerere acolo unde este posibil

400 Cerere greșită - Parametri invalizi

Problemă: Primiți erori 400 cu cereri greșit formatate.

Soluții:

Verificați documentația API pentru parametrii obligatorii și opționali
Verificați tipurile de parametri (șiruri vs numere, tablouri vs obiecte)
Asigurați-vă că JSON-ul este valid și formatat corect
Utilizați URL-uri corecte ale endpointurilor cu parametri de cale adecvați
Verificați greșelile de tipar în numele parametrilor de interogare

Erori de server 5xx - Interrupții temporare

Problemă: Primești erorile 500, 502, 503 sau 504.

Soluții:

Verifică starea serviciului la https://status.smartmoneyapi.com
Implementează o încercare automată cu backoff exponențial (maxim 5-10 încercări)
Așteaptă 30-60 de secunde înainte de a reîncerca erorile 503
Folosește antetul Retry-After pentru a determina momentul reîncercării
Abonează-te la pagina de status pentru notificări de incidente

Formatul răspunsului de eroare

Toate răspunsurile de eroare urmează un format consistent:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Mesaj de eroare ușor de înțeles",
    "details": {...},
    "resolution": "Pași pentru rezolvarea problemei"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ai nevoie de mai mult ajutor?

Consultă documentația noastră API sau contactează suportul cu codul de eroare și detaliile cererii tale.

Referință API

Obține suport

Ai întrebări? Consultă documentația noastră sau contactează suportul.

Deschide consola