ChatGetz API ծրագրավորողների համար

Ճիշտ սկսել

1. Գրանցվել և բացել Dashboard → 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: 1000 հարցումներ ամիս (վերականգնվում է առաջին օրը, մայիսի 1-ին).
• Պլան չունեցող հաշիվները API-ի հասանելիություն չեն ունենում։
• Յուրաքանչյուր կոճակ ունի իր սեփական սահմանափակումը (10-120 խնդրանքներ մեկ րոպեում)։ Լարվածության սահմանից դուրս API-ը պատասխանում է Retry-After գլխամասով՝ 429:
• 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-ի ցանկը: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 կոդը։ Կապը պահվում է պլագինների պարամետրերում, ոչ երբեք՝ կոդում։