ChatGetz API פֿאַר דעוועלאָפּערס

שנעל אָנהייב

1. Sign in and open Dashboard → API keys.
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: אומלעגאַלע API באדערפענישן.
• Basic: 1,000 פֿראגן פּער חודש (גענוגנט אויף דער ערשטער, טאשקענט צייט).
• באַנק אַקאַונץ אָן אַ פּלאַן האָבן ניט קיין API צוטריט.
• Each key has its own rate limit (10–120 requests per minute). Over the limit the API answers 429 with a Retry-After header.
• AI טעקסט דזשענעראַציע איז באַצאָלט דורך די עפנטלעך פּרייַז ליסטינג: ערשטער פון דיין מאָרגן AI צוגעבן, דעמאָלט פון דיין ChatGetz באַלוינונג.
• שיקן אַ Idempotency-Key קאָפּצעטל מיט AI באַדערפענישן: אַ ווידערגעפּרוּווט באַונג מיט דעם זעלבן שליסל איז קיינמאל נישט אָפּגע כן צוויי מאָל.

סוף פונקטן

• 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.jsonדי OpenAPI 3.1 ספּעסאַפאַקיישאַן פון דעם API

פּלוגינס שיקן נײַע אָרדערס און פירן צו 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 קנעפּל. דער קנעפּל איז סטאָרד אין די פּלוגין סעטטינגס, קיינמאָל אין דעם קאָד.