Κωδικοί Σφάλματος & Αναφορά Κατάστασης

Ολοκληρωμένος οδηγός για τους κωδικούς σφάλματος του Smart Money API, τους κωδικούς κατάστασης HTTP και τα βήματα αντιμετώπισης προβλημάτων. Κατανοήστε τις αποκρίσεις σφάλματος και επιλύστε τα ζητήματα ενσωμάτωσης γρήγορα.

Κωδικοί Επιτυχίας 2xx

Οι επιτυχείς αποκρίσεις υποδεικνύουν ότι το αίτημα επεξεργάστηκε με επιτυχία.

Κωδικός	Κατάσταση	Σημασία
200	OK	Το αίτημα ήταν επιτυχές. Το σώμα της απάντησης περιέχει τα ζητούμενα δεδομένα.
201	Created	Ο πόρος δημιουργήθηκε με επιτυχία. Η απάντηση περιλαμβάνει τον νέο πόρο.
204	No Content	Το αίτημα ήταν επιτυχές αλλά δεν υπάρχει περιεχόμενο για επιστροφή (π.χ., DELETE).

Παράδειγμα Απάντησης 200

JSON

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

Κωδικοί Σφάλματος Πελάτη 4xx

Τα σφάλματα πελάτη υποδεικνύουν ότι το αίτημα ήταν εσφαλμένο ή άκυρο. Διορθώστε το αίτημά σας και δοκιμάστε ξανά.

Κωδικός	Κατάσταση	Αιτία
400	Bad Request	Εσφαλμένη σύνταξη αιτήματος. Ελέγξτε τις παραμέτρους ερωτήματος, τις κεφαλίδες και το σώμα του αιτήματος.
401	Unauthorized	Λείπουν ή είναι άκυρα τα διαπιστευτήρια πιστοποίησης. Ελέγξτε το κλειδί API ή το διακριτικό JWT.
402	Payment Required	Η πληρωμή της συνδρομής σας απέτυχε. Ενημερώστε τις πληροφορίες χρέωσης στον λογαριασμό σας.
403	Forbidden	Πιστοποιημένος αλλά μη εξουσιοδοτημένος για αυτόν τον πόρο. Το πλάνο σας δεν περιλαμβάνει αυτήν τη λειτουργία.
404	Not Found	Ο πόρος δεν υπάρχει. Ελέγξτε το URL του τελικού σημείου και τις παραμέτρους.
429	Too Many Requests	Υπέρβαση του ορίου ρυθμού. Περιμένετε πριν από νέα προσπάθεια. Ελέγξτε την κεφαλίδα Retry-After.
422	Unprocessable Entity	Αποτυχία επικύρωσης. Οι παράμετροι αιτήματος είναι άκυρες ή λείπουν υποχρεωτικά πεδία.

Παραδείγματα Σφαλμάτων Πιστοποίησης

Λείπει το Κλειδί API (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Δεν παρέχονται διαπιστευτήρια πιστοποίησης.",
    "resolution": "Συμπεριλάβετε το κλειδί API στην κεφαλίδα Authorization: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Άκυρο Κλειδί API (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Άκυρο ή ληγμένο κλειδί API.",
    "resolution": "Δημιουργήστε ένα νέο κλειδί API από την κονσόλα σας στο https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Περιορισμός Ρυθμού (429)

Όταν υπερβείτε το όριο του API, ο διακομιστής επιστρέφει 429 Too Many Requests. Ελέγξτε τις κεφαλίδες της απάντησης για πληροφορίες περιορισμού ρυθμού:

Κεφαλίδες HTTP

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

Απάντηση Σφάλματος Περιορισμού Ρυθμού

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Υπέρβαση του ημερήσιου ορίου αιτημάτων API (10).",
    "resolution": "Αναβαθμίστε στο πλάνο Trader (29$/μήνα, 400 αιτήματα/ημέρα) ή Pro (79$/μήνα, 4,000 αιτήματα/ημέρα).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Σφάλματα Επικύρωσης (422)

Τα σφάλματα επικύρωσης προκύπτουν όταν οι παράμετροι του αιτήματός σας είναι άκυρες ή λείπουν υποχρεωτικά πεδία.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Αποτυχία επικύρωσης αιτήματος.",
    "details": [
      {
        "field": "symbol",
        "error": "Άκυρο ζεύγος συναλλαγής. Αναμενόμενη μορφή: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Πρέπει να είναι θετικός αριθμός"
      }
    ],
    "resolution": "Διορθώστε τα σφάλματα επικύρωσης και δοκιμάστε ξανά."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Κωδικοί Σφάλματος Διακομιστή 5xx

Τα σφάλματα διακομιστή υποδεικνύουν πρόβλημα από την πλευρά μας. Αυτά είναι προσωρινά και συνήθως επιλύνονται γρήγορα. Υλοποιήστε λογική επανάληψης με εκθετική υποχώρηση.

Κωδικός	Κατάσταση	Ενέργεια
500	Internal Error	Απρόσμενο σφάλμα διακομιστή. Επαναλάβετε με εκθετική υποχώρηση.
502	Bad Gateway	Προσωρινή διακοπή υπηρεσίας. Επαναλάβετε μετά από λίγα δευτερόλεπτα.
503	Service Unavailable	Συντήρηση ή προσωρινή διακοπή. Ελέγξτε τη σελίδα κατάστασης. Επαναλάβετε μετά το διάστημα Retry-After.
504	Gateway Timeout	Το αίτημα διήρκησε πολύ. Ο διακομιστής μπορεί να το έχει επεξεργαστεί ούτως ή άλλως. Ελέγξτε την ισχύ.

Παράδειγμα Σφάλματος Διακομιστή (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Η υπηρεσία είναι προσωρινά μη διαθέσιμη λόγω συντήρησης.",
    "resolution": "Παρακαλώ επαναλάβετε μετά από 5 λεπτά. Παρακολουθήστε την κατάσταση στο https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Οδηγός Αντιμετώπισης Προβλημάτων

401 Unauthorized - Άκυρο Κλειδί API

Πρόβλημα: Λαμβάνετε σφάλματα 401 ακόμη και με κλειδί API.

Λύσεις:

Επαληθεύστε ότι το κλειδί API περιλαμβάνεται στην κεφαλίδα Authorization με το πρόθεμα "Bearer"
Ελέγξτε ότι το κλειδί API δεν έχει λήξει ή ακυρωθεί
Βεβαιωθείτε ότι χρησιμοποιείτε το σωστό κλειδί (παραγωγή, staging ή ανάπτυξη)
Δημιουργήστε ένα νέο κλειδί API από την κονσόλα σας εάν το τρέχον έχει χαθεί

403 Forbidden - Λειτουργία Μη Διαθέσιμη

Πρόβλημα: Λαμβάνετε σφάλματα 403 σε ορισμένα τελικά σημεία.

Λύσεις:

Ελέγξτε το επίπεδο του API. Ορισμένα τελικά σημεία απαιτούν πλάνα Trader ή Pro
Αναβαθμίστε το πλάνο σας στο /pricing.html για πρόσβαση σε premium λειτουργίες
Επαληθεύστε ότι το κλειδί API έχει ενεργοποιημένες τις απαιτούμενες δικαιώματα
Επικοινωνήστε με την υποστήριξη εάν πιστεύετε ότι θα έπρεπε να έχετε πρόσβαση

429 Too Many Requests - Περιορισμός Ρυθμού

Πρόβλημα: Λαμβάνετε σφάλματα 429 και περιορισμό ρυθμού.

Λύσεις:

Υλοποιήστε λογική επανάληψης με εκθετική υποχώρηση (περιμένετε 1s, 2s, 4s, κλπ.)
Προσωρινά αποθηκεύστε τις αποκρίσεις για να αποφύγετε περιττές κλήσεις API
Χρησιμοποιήστε WebSocket για δεδομένα σε πραγματικό χρόνο αντί για δημοσκοπήσεις REST
Αναβαθμίστε το πλάνο σας για υψηλότερα όρια (Trader 1,000/ημέρα, Pro 5,000/ημέρα)
Συγκεντρώστε πολλαπλά ερωτήματα σε ενιαία αιτήματα όπου είναι δυνατόν

400 Bad Request - Άκυρες Παράμετροι

Πρόβλημα: Λαμβάνετε σφάλματα 400 με εσφαλμένα αιτήματα.

Λύσεις:

Ελέγξτε την τεκμηρίωση του API για υποχρεωτικές και προαιρετικές παραμέτρους
Επαληθεύστε τους τύπους παραμέτρων (συμβολοσειρές vs αριθμοί, πίνακες vs αντικείμενα)
Βεβαιωθείτε ότι το JSON είναι έγκυρο και σωστά μορφοποιημένο
Χρησιμοποιήστε σωστά URLs τελικών σημείων με κατάλληλες παραμέτρους διαδρομής
Ελέγξτε για τυπογραφικά λάθη στα ονόματα των παραμέτρων του ερωτήματος

Σφάλματα διακομιστή 5xx - Προσωρινές διακοπές

Πρόβλημα: Λαμβάνετε σφάλματα 500, 502, 503 ή 504.

Λύσεις:

Ελέγξτε την κατάσταση της υπηρεσίας στη διεύθυνση https://status.smartmoneyapi.com
Υλοποιήστε αυτόματη επανάληψη με εκθετική υποχώρηση (μέγιστες 5-10 προσπάθειες)
Περιμένετε 30-60 δευτερόλεπτα πριν από επανάληψη για σφάλματα 503
Χρησιμοποιήστε την κεφαλίδα Retry-After για να καθορίσετε το χρονισμό επανάληψης
Εγγραφείτε στη σελίδα κατάστασης για ειδοποιήσεις περιστατικών

Μορφή Απόκρισης Σφάλματος

Όλες οι αποκρίσεις σφάλματος ακολουθούν μια συνεπή μορφή:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Αναγνώσιμο από ανθρώπους μήνυμα σφάλματος",
    "details": {...},
    "resolution": "Βήματα για επίλυση του προβλήματος"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Χρειάζεστε περισσότερη βοήθεια;

Ελέγξτε την τεκμηρίωση του API ή επικοινωνήστε με την υποστήριξη με τον κωδικό σφάλματος και τις λεπτομέρειες του αιτήματος.

Αναφορά API

Λήψη Υποστήριξης

Έχετε ερωτήσεις; Ελέγξτε την τεκμηρίωσή μας ή επικοινωνήστε με την υποστήριξη.

Άνοιγμα Κονσόλας