Μετάβαση στο περιεχόμενο
Αρχική Τεκμηρίωση Error Codes
Nutrition Hub · Diagnostics

Error Codes

Αναζητήστε κωδικούς σφάλματος του Nutrition Hub και δείτε τι σημαίνουν, ποια είναι η πιθανή αιτία, τι μπορείτε να ελέγξετε και πότε απαιτείται τεχνική υποστήριξη.

Εμφανίζονται όλοι οι κωδικοί.

License Calendar Email Payments AI Files Security API
How to read an error

Πώς διαβάζουμε έναν κωδικό

NH _ CALENDAR _ SYNC_FAILED
Prefix

NH

Δηλώνει ότι ο κωδικός προέρχεται από το Nutrition Hub.

Domain

CALENDAR

Δείχνει το module ή την integration που επηρεάζεται.

Condition

SYNC_FAILED

Περιγράφει τη συγκεκριμένη τεχνική κατάσταση.

Request ID

Τεχνική αναφορά

Χρησιμοποιείται για ασφαλή συσχέτιση logs χωρίς raw payload.

Ο κωδικός δεν είναι ολόκληρο το περιστατικό.

Για σωστή διάγνωση χρειάζονται επίσης timestamp, request ID, plugin version, environment και πρόσφατες αλλαγές.

Error catalog

Κατάλογος σφαλμάτων

License

NH_LICENSE_EXPIRED

Action required

Η άδεια ή η πληρωμένη περίοδος έχει λήξει.

Πιθανή αιτία
Η συνδρομή δεν ανανεώθηκε ή το renewal δεν επιβεβαιώθηκε.
Τι να ελέγξετε
Account portal, payment status, renewal date και license refresh.
Retry
Όχι πριν ολοκληρωθεί η ανανέωση.
Support
Ναι, όταν η πληρωμή έχει ολοκληρωθεί αλλά η άδεια παραμένει expired.
Οδηγός άδειας →
License

NH_DOMAIN_MISMATCH

Action required

Το domain του site δεν ταιριάζει με το domain που είναι δεσμευμένο στην άδεια.

Πιθανή αιτία
Migration, αλλαγή www/non-www, HTTP/HTTPS ή staging/production mismatch.
Τι να ελέγξετε
WordPress Site URL, Home URL και license domain binding.
Retry
Μετά τη διόρθωση ή μεταφορά της άδειας.
Support
Ναι, όταν απαιτείται manual domain reset.
Migration guide →
License / Security

NH_INVALID_SIGNATURE

Security

Η υπογραφή του request δεν επαληθεύτηκε.

Πιθανή αιτία
Λάθος secret, αλλοιωμένο body, λανθασμένη canonical string ή clock mismatch.
Τι να ελέγξετε
Credentials, raw body, timestamp, server time και signing implementation.
Retry
Όχι με το ίδιο ακριβώς request χωρίς διόρθωση.
Support
Ναι, με request ID και timestamp — ποτέ με το secret.
API signing guide →
License

NH_LICENSE_SUSPENDED

Manual review

Η άδεια έχει τεθεί προσωρινά σε αναστολή.

Πιθανή αιτία
Billing issue, security review ή διοικητικός περιορισμός.
Τι να ελέγξετε
Account notices, billing status και email λογαριασμού.
Retry
Όχι μέχρι την άρση της αναστολής.
Support
Ναι.
Billing guide →
Google Calendar

NH_CALENDAR_TOKEN_EXPIRED

Reconnect

Το Calendar token δεν μπορεί πλέον να χρησιμοποιηθεί.

Πιθανή αιτία
Revoked access, expired grant ή αλλαγή Google account security.
Τι να ελέγξετε
Connection status και Google account access.
Retry
Μετά από Disconnect και νέα authorization.
Support
Όταν η επανασύνδεση αποτυγχάνει.
Google Calendar guide →
Google Calendar

NH_CALENDAR_SYNC_FAILED

Retryable

Η δημιουργία ή ενημέρωση calendar event απέτυχε.

Πιθανή αιτία
Network error, invalid calendar ID, token issue ή provider response.
Τι να ελέγξετε
Connection status, calendar ID, timezone και τελευταίο sync log.
Retry
Ναι για προσωρινές αποτυχίες.
Support
Όταν αποτυγχάνει επανειλημμένα με το ίδιο appointment.
Calendar troubleshooting →
Google OAuth

NH_CALENDAR_REDIRECT_MISMATCH

Configuration

Η OAuth callback URL δεν ταιριάζει με την εγκεκριμένη redirect URI.

Πιθανή αιτία
Λάθος domain, path, scheme ή trailing slash.
Τι να ελέγξετε
Google Cloud OAuth client και production callback URL.
Retry
Μετά τη διόρθωση της redirect URI.
Support
Όταν δεν είναι γνωστή η σωστή callback URL.
Google integration page →
Email

NH_EMAIL_DELIVERY_FAILED

Retryable

Ο email provider δεν αποδέχτηκε ή δεν παρέδωσε το μήνυμα.

Πιθανή αιτία
Provider error, invalid recipient, authentication ή sender-domain issue.
Τι να ελέγξετε
Delivery status, provider response, SPF, DKIM, DMARC και recipient.
Retry
Ναι για προσωρινά provider errors, όχι για permanent bounce.
Support
Όταν αποτυγχάνουν πολλαπλά έγκυρα recipients.
Email guide →
Email Queue

NH_EMAIL_QUEUE_STALLED

Cron check

Η ουρά email δεν επεξεργάζεται pending μηνύματα.

Πιθανή αιτία
WP-Cron/server cron, queue lock ή hosting resource limit.
Τι να ελέγξετε
Last cron run, pending count, failed jobs και server logs.
Retry
Μετά την αποκατάσταση του cron/worker.
Support
Όταν η queue παραμένει stalled μετά από manual run.
Cron requirements →
Payments

NH_PAYMENT_WEBHOOK_INVALID_SIGNATURE

Security

Η υπογραφή του payment webhook δεν επαληθεύτηκε.

Πιθανή αιτία
Λάθος webhook secret, raw-body handling ή λάθος environment.
Τι να ελέγξετε
Production/test secret, endpoint, raw body και provider configuration.
Retry
Όχι πριν διορθωθεί η verification ρύθμιση.
Support
Ναι, με event ID και timestamp.
Payment guide →
Payments

NH_PAYMENT_EVENT_DUPLICATE

Handled

Το payment event έχει ήδη επεξεργαστεί.

Πιθανή αιτία
Provider retry ή duplicate delivery.
Τι να ελέγξετε
Event ID και προηγούμενο processing status.
Retry
Όχι. Επιστρέφεται idempotent success.
Support
Μόνο αν δημιουργήθηκε δεύτερη χρέωση ή δεύτερη οικονομική εγγραφή.
Idempotency guide →
Payments

NH_PAYMENT_STATUS_CONFLICT

Manual review

Το νέο payment status συγκρούεται με την τρέχουσα κατάσταση.

Πιθανή αιτία
Out-of-order webhook, manual change ή provider inconsistency.
Τι να ελέγξετε
Event timestamps, provider dashboard και subscription history.
Retry
Όχι πριν επιβεβαιωθεί η σωστή τελική κατάσταση.
Support
Ναι.
Billing guide →
AI

NH_AI_QUOTA_EXCEEDED

Plan limit

Έχει εξαντληθεί το διαθέσιμο AI quota.

Πιθανή αιτία
Μηνιαίο request ή token limit του πλάνου.
Τι να ελέγξετε
Usage dashboard, billing cycle και ενεργό plan.
Retry
Μετά την ανανέωση quota ή αλλαγή πλάνου.
Support
Όταν το usage count φαίνεται λανθασμένο.
AI guide →
AI

NH_AI_PROXY_UNAVAILABLE

Retryable

Ο κεντρικός AI proxy δεν είναι προσωρινά διαθέσιμος.

Πιθανή αιτία
Network issue, maintenance ή upstream provider failure.
Τι να ελέγξετε
Status page, outbound HTTPS και request ID.
Retry
Ναι με backoff.
Support
Όταν συνεχίζεται για μεγάλο διάστημα.
System status →
AI

NH_AI_TASK_NOT_ALLOWED

Not permitted

Το requested AI task δεν επιτρέπεται για το plan ή το feature set.

Πιθανή αιτία
Task εκτός allowlist ή μη ενεργό feature.
Τι να ελέγξετε
Active plan, feature flags και task type.
Retry
Όχι χωρίς αλλαγή configuration.
Support
Όταν το task θα έπρεπε να περιλαμβάνεται στο plan.
AI permissions →
Files

NH_FILE_ACCESS_DENIED

Access denied

Ο χρήστης δεν έχει δικαίωμα πρόσβασης στο αρχείο.

Πιθανή αιτία
Λάθος tenant, patient relation, role ή visibility setting.
Τι να ελέγξετε
User role, file ownership, sharing status και patient mapping.
Retry
Όχι χωρίς σωστή εξουσιοδότηση.
Support
Όταν ο εξουσιοδοτημένος owner απορρίπτεται λανθασμένα.
Protected files guide →
Files

NH_FILE_UPLOAD_REJECTED

Validation

Το αρχείο απορρίφθηκε από τους κανόνες upload.

Πιθανή αιτία
Μη επιτρεπτός τύπος, μέγεθος, MIME mismatch ή security scan.
Τι να ελέγξετε
Filename, extension, actual MIME type και upload limit.
Retry
Με επιτρεπτό και έγκυρο αρχείο.
Support
Όταν επιτρεπτό αρχείο απορρίπτεται σταθερά.
Upload requirements →
Files

NH_STORAGE_UNAVAILABLE

Infrastructure

Το protected storage δεν είναι διαθέσιμο ή εγγράψιμο.

Πιθανή αιτία
Disk full, permissions, mount failure ή storage service outage.
Τι να ελέγξετε
Disk space, filesystem permissions και storage health.
Retry
Μετά την αποκατάσταση της υποδομής.
Support
Ναι, αν δεν υπάρχει πρόσβαση σε server diagnostics.
Storage requirements →
Security

NH_ACCESS_DENIED

Authorization

Ο authenticated χρήστης δεν έχει permission για τη συγκεκριμένη ενέργεια.

Πιθανή αιτία
Λάθος role, capability ή resource ownership.
Τι να ελέγξετε
User role, tenant context και server-side permission mapping.
Retry
Όχι χωρίς σωστή εξουσιοδότηση.
Support
Όταν ο σωστός ρόλος δεν λαμβάνει αναμενόμενη πρόσβαση.
Roles guide →
Security

NH_SESSION_EXPIRED

Sign in again

Η ενεργή session έχει λήξει ή ανακληθεί.

Πιθανή αιτία
Timeout, logout, password change ή security revoke.
Τι να ελέγξετε
Νέα σύνδεση και browser cookies.
Retry
Μετά από νέα authentication.
Support
Όταν οι sessions λήγουν αμέσως ή επανειλημμένα.
Session security →
Security / API

NH_RATE_LIMIT_EXCEEDED

Retry later

Έγιναν περισσότερα requests από το επιτρεπτό όριο.

Πιθανή αιτία
Πολλά requests, loop, abuse protection ή exhausted quota.
Τι να ελέγξετε
Retry-After, request frequency και client loop.
Retry
Ναι μετά το καθορισμένο backoff.
Support
Όταν κανονική χρήση μπλοκάρεται συνεχώς.
Rate limits →
API

NH_API_VALIDATION_FAILED

Fix request

Το request είναι συντακτικά έγκυρο αλλά δεν περνά το API schema ή business validation.

Πιθανή αιτία
Missing field, λάθος type, unknown event ή invalid business state.
Τι να ελέγξετε
Field names, types, required values και active feature.
Retry
Μόνο μετά τη διόρθωση του request.
Support
Όταν το payload συμφωνεί με το documented schema.
Request format →
API

NH_API_TEMPORARILY_UNAVAILABLE

Retryable

Η κεντρική υπηρεσία δεν είναι προσωρινά διαθέσιμη.

Πιθανή αιτία
Maintenance, network issue ή service degradation.
Τι να ελέγξετε
Status page, outbound connectivity και Retry-After.
Retry
Ναι με exponential backoff.
Support
Όταν το status page είναι πράσινο αλλά η αποτυχία συνεχίζεται.
System status →
API Security

NH_REQUEST_REPLAY_DETECTED

Security

Το request φαίνεται να έχει επαναληφθεί ή να χρησιμοποιεί παλιό timestamp/request ID.

Πιθανή αιτία
Duplicate request, stale queue item ή πιθανό replay.
Τι να ελέγξετε
Server time, unique request IDs και queue retry behavior.
Retry
Με νέο request ID και τρέχον timestamp, μόνο αν είναι νόμιμη νέα προσπάθεια.
Support
Ναι όταν εμφανίζεται χωρίς duplicate processing.
Replay protection →
Retry guide

Πότε επαναλαμβάνουμε ένα request

Κατηγορία Retry; Παράδειγμα
Temporary network/provider failure Ναι, με backoff NH_API_TEMPORARILY_UNAVAILABLE
Rate limit Ναι, μετά το Retry-After NH_RATE_LIMIT_EXCEEDED
Invalid credentials/signature Όχι χωρίς διόρθωση NH_INVALID_SIGNATURE
Validation error Όχι χωρίς αλλαγή payload NH_API_VALIDATION_FAILED
Permission error Όχι χωρίς αλλαγή access NH_ACCESS_DENIED
Duplicate event Όχι NH_PAYMENT_EVENT_DUPLICATE
Support request

Τι να στείλετε στην υποστήριξη

Συμπεριλάβετε
  • Error code
  • Request ID ή event ID
  • Ημερομηνία και ώρα με timezone
  • Domain και environment
  • WordPress και Nutrition Hub version
  • Βήματα αναπαραγωγής
  • Πρόσφατες αλλαγές
Μην συμπεριλάβετε
  • Passwords
  • License secret
  • API ή webhook secret
  • OAuth token
  • Πλήρη patient data
  • Raw payment card data
Προτεινόμενο θέμα email Nutrition Hub — [ERROR_CODE] — [Domain]
FAQ

Συχνές ερωτήσεις

Πού εμφανίζεται το request ID;

Μπορεί να εμφανίζεται στο ασφαλές error message, στο diagnostic panel ή στα privacy-safe logs. Δεν πρέπει να περιέχει προσωπικά δεδομένα.

Μπορώ να αγνοήσω ένα error που λύθηκε μόνο του;

Ένα μεμονωμένο retryable error μπορεί να είναι προσωρινό. Επαναλαμβανόμενα errors ή αυξανόμενα retries χρειάζονται έλεγχο πριν δημιουργηθεί backlog.

Γιατί δύο διαφορετικά errors έχουν παρόμοια συμπτώματα;

Το ίδιο σύμπτωμα μπορεί να οφείλεται σε authentication, configuration, network ή provider issue. Ο κωδικός και το request ID βοηθούν στον διαχωρισμό.

Είναι όλοι οι κωδικοί δημόσιοι;

Όχι απαραίτητα. Η δημόσια σελίδα πρέπει να περιέχει μόνο codes που είναι χρήσιμα και ασφαλή για administrators και developers.

Next public page

Changelog

Η επόμενη σελίδα οργανώνει εκδόσεις, νέες λειτουργίες, διορθώσεις, security updates και required actions.

Επόμενη σελίδα