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: வரையறுக்கப்படாத API கோரிக்கைகள்.
• Basic: 1,000 தேடல்கள் per month (resets on the 1st, Tashkent time).
• திட்டமிடப்பட்ட API அணுகலை இல்லை.
• ஒவ்வொரு விசைக்கும் அதன் சொந்தமான வீத வரம்பு உள்ளது (நிமிடத்திற்கு 10–120 கோரிக்கைகள்). வரம்புக்கு மேல் API ஒரு Retry-After தலைப்புடன் 429.
• AI உரை உருவாக்கம் பொது விலை பட்டியலின்படி வசூலிக்கப்படுகிறது: முதலில் உங்கள் மாத AI உதவித்தொகை, பின்னர் உங்கள் ChatGetz சமநிலை.
• AI கோரிக்கைகளுடன் ஒரு Idempotency-Key தலைப்பை அனுப்பவும்: அதே விசையுடன் மீண்டும் முயற்சிக்கப்படும் கோரிக்கை இரண்டு முறையும் வசூலிக்கப்படுவதில்லை.

முடிவுப் புள்ளிகள்

• get/api/v1/account/balanceதிட்டம், சமநிலை, AI உதவித்தொகை மற்றும் 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.jsonOpenAPI,3.1 விவர Ý API

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

செருகல்கள்

அனைத்து செருகல்களும் திறந்த மூலமாகும் (ஜிபிஎல்-க்கு ஏற்றது) மற்றும் உங்கள் API விசை பயன்படுத்தப்படுகிறது. இந்த விசை மென்பொருள் அமைப்புகளில் சேமிக்கப்படுகிறது, எப்போதும் குறியீட்டில் இல்லை.