ડેવલપર્સ માટે 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)."
  }'

સત્તાધિકરણ અને વિસ્તારો

Every request needs a personal API key in the Authorization: Bearer cgk_… header (or X-API-Key). Each key has its own permissions (scopes) and rate limit and can be revoked at any time.

તમારા સર્વર પર કી રાખો, ક્યારેય જાહેર ફ્રોન્ટ-એન્ડ કોડમાં નહીં. ChatGetz ફક્ત દરેક કીની એક SHA-256 હેશ સંગ્રહ કરે છે.

મર્યાદાઓ અને કિંમત

• Global Pro: unlimited API requests.
• Basic: 1,000 વિનંતી દર મહિને (જૂન, તાશ્કંદ સમય પર પુનઃસુયોજિત થાય છે).
• પ્લાનની ખાતરી, યોજના વગરના ખાતાઓ માટે APIનો ઉપયોગ કરવો અશક્ય છે.
• દરેક કી પાસે પોતાની જ દર સીમા છે (મિનિટ દીઠ 10-120 વિનંતી). મર્યાદાથી વધુ API જવાબો અને Retry-After હેડર સાથે 429 છે.
• એઆઈ લખાણ ઉત્પાદન માટે કીય ભાવનીખણી દ્વારા ચાર્જ કરવામાં આવે છે: પ્રથમ તમારી માસિક એઆઇ ભથ્થામાંથી, પછી તમારા ChatGetz બેલેન્સથી.
• ની વિનંતીઓ સાથે એક 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. તરફ લઈ જાય છે.

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 કીને વાપરે છે. કી કોડમાં ક્યારેય નહીં, પણ પ્લગઇન સુયોજનોમાં સંગ્રહાયેલ છે.