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 ଗୋଟିଏ ପୁନଃପ୍ରୟାସ-ପରେ ଶୀର୍ଷକ ସହିତ 429 କୁ ଉତ୍ତର ଦେଇଥାଏ ।
• ଏଆଇ ପାଠ୍ୟ ମାଧ୍ୟମରେ ସାଧାରଣ ଦର ତାଲିକା ଦ୍ୱାରା ଭର୍ତ୍ତି କରାଯାଏ: ପ୍ରଥମେ ଆପଣଙ୍କ ମାସିକ ଏଆଇ ଅନୁଦାନରୁ, ପରେ ଆପଣChatGetz ବାଲ୍ୟୁ.
• AI ଅନୁରୋଧ ସହିତ ଏକ 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.jsonOpenAPI 3.1 ବିବର Ý API

ପ୍ଲଗଇନଗୁଡ଼ିକ ନୂତନ ଆଦେଶକୁ ଦବାଇଥାଏ ଏବଂ 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. ..."
  }
}

ପ୍ଲଗଇନ

ସମସ୍ତ ପ୍ଲଗଇନଗୁଡ଼ିକ ମୁକ୍ତ ଉତ୍ସ (GPL-ସୁବିଧାଜନକ) ଏବଂ ଆପଣଙ୍କର API କି ବ୍ୟବହାର କରିଥାଏ । ଏହି କିକୁ ପ୍ଲଗଇନ ସେଟିଂସରେ ସଂରକ୍ଷିତ କରାଯାଇଥାଏ, କୋଡରେ କେବେବି ନାହିଁ ।