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

การตรวจสอบสิทธิ์และขอบเขตการใช้งาน การตรวจสอบความถูกต้องและขอบเขตการใช้งาน

ทุกคำร้องขอต้องการกุญแจส่วนตัว API ในหัวข้อ Authorization: Bearer cgk_… (หรือ X-API-Key)กุญแจแต่ละกุญแจมีสิทธิ์ (ขอบเขต) และอัตราการใช้งานของมันเองและสามารถถูกยกเลิกได้เมื่อใดก็ได้

เก็บกุญแจไว้ที่เซิร์ฟเวอร์ของคุณ หรือมาจากไหนกัน ไม่อยู่ในรหัสหน้า-ท้ายสาธารณะChatGetz. ร้านค้าเป็นชั่วโมง ขนาด SHA-256 กัญชาของแต่ละคีย์.

ขอบเขตและราคา ข้อจำกัดและราคา

• Global Pro: ไม่ จำกัด การร้องขอที่ API.
• Basic: คำขอทั้งหมด 1,000 ครั้ง ต่อเดือน (รีเซ็ตในวันที่ 1 เวลาตาชเคนท์).
• บัญชีที่ไม่มีแผนจะไม่สามารถเข้าถึง API ได้
• กุญแจแต่ละกุญแจมีอัตราการขอรับที่จำกัดไว้ (10–120 คำร้องต่อนาที)หากเกินขอบเขตที่กำหนด API จะส่งข้อความกลับมายัง 429 โดยมีหัว Retry-After
• การสร้างข้อความแบบ AI จะถูกเรียกเก็บตามรายการราคาสาธารณะ: ครั้งแรกจากอัตราการจ่าย AI ของคุณต่อเดือน, จากนั้นจากสภาพคล่อง ChatGetz ของคุณ.
• ส่งหัวข้อ Idempotency-Key กับคำร้องขอ AI: การพยายามทำการร้องเรียนใหม่ด้วยกุญแจเดียวกันจะไม่ถูกเรียกเก็บค่าบริการสองครั้ง

จุดจบ (Endpoints) และจุดหมายปลายทาง

• 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 ของท่านกุญ ถูกเก็บไว้ในการตั้งค่าของโปรแกรมเสริม ไม่เคยอยู่ในโค้ดเลย