ChatGetz API για προγραμματιστές

Γρήγορη εκκίνηση

1. Συνδεθείτε και ανοίξτε τον Πίνακα Ελέγχου → API πλήκτρα.
2. Δημιουργήστε ένα κλειδί με τα δικαιώματα που χρειάζεστε και αντιγράψτε το (εμφανίζεται μόνο μία φορά).
3. Στείλτε το στην κεφαλίδα Authorization: Bearer cgk_…

curl https://www.chatgetz.uz/api/v1/account/balance \
  -H "Authorization: Bearer $CHATGETZ_API_KEY"

curl https://www.chatgetz.uz/api/v1/ai/generate \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f0c6f5e-order-42" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "prompt": "Write a 60-word description for a cotton kids hoodie",
    "instructions": "Answer in Uzbek (Latin script)."
  }'

Επικύρωση και πεδίο εφαρμογής

Κάθε αίτημα χρειάζεται ένα προσωπικό API κλειδί στην κεφαλίδα Authorization: Bearer cgk_… (ή X-API-Key). Κάθε κλειδί έχει τα δικά του δικαιώματα (πεδία εφαρμογής) και όριο ρυθμού και μπορεί να ανακληθεί ανά πάσα στιγμή.

Διατηρήστε τα κλειδιά στο διακομιστή σας ή στις ρυθμίσεις του προσθέτου, ποτέ στον δημόσιο κώδικα Το προϊόν δεν απαιτεί τη δημιουργία ενός-διαχειριστή. Το ChatGetz αποθηκεύει μόνο ένα κατακερματισμό SHA-256 για κάθε κλειδί.

Όρια και τιμολόγηση

• Global Pro: απεριόριστες API αιτήσεις.
• Basic: 1.000 αιτήματα ανά μήνα (επαναφορά την πρώτη, ώρα Τασκένδης).
• Οι λογαριασμοί χωρίς πρόγραμμα δεν έχουν πρόσβαση στο API.
• Κάθε κλειδί έχει το δικό του όριο ταχύτητας (10–120 αιτήσεις ανά λεπτό). Πάνω από το όριο ο API απαντά στον 429 ς με μια επικεφαλίδα Επανάληψη-μετά.
• Η δημιουργία κειμένων τεχνητής νοημοσύνης χρεώνεται σύμφωνα με τον δημόσιο τιμοκατάλογο: πρώτα από το μηνιαίο επίδομα και στη συνέχεια από το υπόλοιπο ChatGetz.
• Αποστολή κεφαλίδας κλειδιού με αιτήματα τεχνητής νοημοσύνης: μια επαναλαμβανόμενη προσία με το ίδιο κλειδί δεν χρεώνεται ποτέ δύο φορές.

Ακραία σημεία

• get/api/v1/account/balancePlan, balance, included AI allowance and API quotaaccount:read
• get/api/v1/modelsΚείμενο μοντέλα και τη διαθεσιμότητα τους για το κλειδί σαςai:generate
• post/api/v1/ai/generateΔημιουργία κειμένουai:generate
• get/api/v1/market/listingsΚαταχωρήσεις σας ChatGetz Αγοράmarket:read
• post/api/v1/market/listingsΔημιουργήστε μια καταχώριση στην Αγορά (ένα πρόχειρο από προεπιλογή)market:write
• post/api/v1/ingest/eventsΛήψη μιας παραγγελίας ή ενός πελάτη από ένα πρόσθετο (Λάβετε μια παραγγελία ή έναν πελάτη μέσω ενός προσθέτουingest:write
• get/api/v1/openapi.jsonΗ προδιαγραφή OpenAPI 3.1 αυτής της API

Οι προσθήκες ωθούν νέες εντολές και οδηγούν στην ΟΠΟΙΟΣΤΑΝΤΑΚΗ ΕΞΕΥΡΕΣΗ /api/v1/ingest/events. Η εκ νέου αποστολή ενός συμβάντος με την ίδια προέλευση, τον ίδιο τύπο και το ίδιο είναι ασφαλής Η επαναπροώθηση ενός συμβάντος με την ίδια πηγή

curl https://www.chatgetz.uz/api/v1/ingest/events \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "order", "source": "woocommerce", "externalId": "1042",
    "customer": { "name": "Aziza", "phone": "+998901234567" },
    "total": { "amount": "249000", "currency": "UZS" },
    "items": [{ "name": "Hoodie", "quantity": 1, "price": "249000" }]
  }'

Λάθη

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

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly Basic API quota exhausted. ..."
  }
}

Προσθήκες

Όλα τα πρόσθετα είναι ανοικτού κώδικα (συμβατά με την άδεια χρήσης) και χρησιμοποιούν το κλειδί σας API. Το κλειδί αποθηκεύεται στις ρυθμίσεις της προσθήκης, ποτέ στον κώδικα.