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)."
  }'

ధృవీకరణ మరియు పరిధి

ప్రతి అభ్యర్ధనకు Authorization: Bearer cgk_… హెడర్‌లో (లేదా X-API-Key) ఒక వ్యక్తిగత API కీ అవసరం. ప్రతి కీకి దాని సొంత అనుమతులు (విస్తీర్ణం) మరియు రేటు పరిమితి ఉంటుంది మరియు ఎప్పుడైనా రద్దు చేయవచ్చు.

Keep keys on your server or in plugin settings, never in public front-end code. ChatGetz stores only a SHA-256 hash of each key.

పరిమితులు మరియు ధరలు

• Global Pro: unlimited API requests.
• Basic: ప్రతి నెలకు 1,000 అభ్యర్ధనలు (తాష్కెంట్ సమయం ప్రకారం మొదటి రోజున పునరుద్ధరించబడుతుంది).
• ప్రణాళిక లేని ఖాతాలకు API సదుపాయం లేదు.
• ప్రతి కీకి దాని స్వంత వేగం పరిమితి (నిమిషానికి 10–120 అభ్యర్ధనలు). పరిమితికి మించి API ఒక రిట్రీ-అఫర్ హెడర్‌తో 429 కు సమాధానం ఇస్తుంది.
• ఎఐ టెక్స్ట్ జనరేషన్ పబ్లిక్ ధర జాబితా ద్వారా వసూలు చేయబడుతుంది: మొదట మీ నెలవారీ ఎఐ బకాయిల నుండి, ఆపై మీ ChatGetz బ్యాలెన్స్ నుండి.
• AI అభ్యర్థనలతో ఒక Idempotency-Key హెడర్‌ను పంపండి: అదే కీతో తిరిగి ప్రయత్నించిన అభ్యర్థనను ఎప్పుడూ రెండుసార్లు ఛార్జ్ చేయబడదు.

ఎండ్ పాయింట్లు

• get/api/v1/account/balanceప్రణాళిక, సమతుల్యత, ఎఐ అనుమతి మరియు API కోటా కూడా ఉన్నాయిaccount: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ఈ API.1 యొక్క OpenAPI 3.1 స్పెసిఫికేషన్

ప్లగిన్లు కొత్త ఆదేశాలను పంపించి POST /api/v1/ingest/events. కు దారితీస్తాయి అదే మూలం, రకం మరియు externalId తో ఒక సంఘటనను తిరిగి పంపడం సురక్షితం: ఇది ఒక్కసారి మాత్రమే నిల్వ చేయబడుతుంది.

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. ..."
  }
}

ప్లగిన్లు

అన్ని ప్లగిన్లు పొర్డ్ (GPL-సమర్థవంతం) మరియు మీ API కీని ఉపయోగించండి. ఈ కీని ఎప్పుడూ కోడ్‌లో కాదు, ప్లగిన్ సెట్టింగ్‌లలో భద్రపరుస్తారు.