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 കീ ആവശ്യമാണ്. ഓരോ കീക്കും അവയുടെ സ്വന്തം അനുമതികളും (സ്കോപ്പുകളും) നിരക്ക് പരിധിയും ഉണ്ട്.

പബ്ലിക് ഫ്രണ്ട് എന്‍ഡ് കോഡില്‍ ഒരിക്കലും സൂക്ഷിക്കാതിരിക്കുക, നിങ്ങളുടെ സര്‍വറുകളിലോ പ്ലഗിന്‍ സെറ്റിങ്ങുകളില്‍ കാശ് സൂക്ഷിക്കണം. ChatGetz ഓരോ കീയുടെയും ഒരു SHA-256 ഹാസ്സ് മാത്രമേ സൂക്ഷിക്കു.

പരിമിതികളും വിലയും

• Global Pro: അപരിമിതമായ API റിക്വസ്റ്റ്.
• Basic: മാസംതോറും 1,000 അപേക്ഷകള്‍ (ടഷ്കെന്റ് സമയത്തിന്‍റെ ഒന്നാം തീയതിയില്‍ വീണ്ടും സജ്ജമാക്കും).
• പദ്ധതി ഇല്ലാത്ത അക്കൗണ്ടുകള്‍ API ആക്സസ് ചെയ്യാന്‍ കഴിയില്ല.
• ഓരോ കീയ്ക്കും അതതു നിരക്കിലെ പരിധിയുണ്ട് (10–120 ആവശ്യങ്ങൾ ഒരു മിനിറ്റിൽ). പരിധിക്കപ്പുറം API ഒരു Retry-After ഹെഡര്‍ ഉപയോഗിച്ച് 429ന് ഉത്തരമേകുന്നു.
• എഐ ടെക്സ്റ്റ് സൃഷ്ടിക്കല്‍ പൊതു വിലപട്ടിക പ്രകാരം ഈടാക്കപ്പെടുന്നു: ആദ്യം നിങ്ങളുടെ മാസത്തെ എഐ അനുവദനത്തില്‍ നിന്ന്, പിന്നെ നിങ്ങളുടെ ChatGetz ബാലന്‍സില്‍ നിന്നും.
• എഐ അപേക്ഷകളോടൊപ്പം ഒരു ഐഡംപോടെന്‍സി-കീ ഹെഡര്‍ അയയ്ക്കുക: ഒരേ കീ ഉപയോഗിച്ച് വീണ്ടും ശ്രമിക്കുന്ന അപേക്ഷയ്ക്ക് രണ്ടു തവണയും ഫീസ് ഈടാക്കുകയില്ല.

എന്‍ഡ്പോയിന്റുകള്‍

• 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.jsonThe OpenAPI 3.1 specification of this 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 കീ ഉപയോഗിക്കുന്നു. ഈ കീ പ്ലഗിൻ സെറ്റിംഗുകളിൽ സൂക്ഷിക്കുന്നു, ഒരിക്കലും കോഡിൽ അല്ല.