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: ਅਗਿਆਤ API ਬੇਨਤੀਆਂ.
• Basic: 1,000 ਬੇਨਤੀਆਂ ਪ੍ਰਤੀ ਮਹੀਨਾ (ਤਾਸ਼ਕਿਨਟ ਸਮਾਂ, ਪਹਿਲੇ ਦਿਨ ਮੁੜ-ਨਿਯੰਤਰਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ).
• ਬਿਨਾ ਯੋਜਨਾ ਦੇ ਖਾਤਿਆਂ ਵਿੱਚ API ਪਹੁੰਚ ਨਹੀਂ ਹੈ।
• ਹਰੇਕ ਕੀ ਦੀ ਆਪਣੀ ਰੇਟ ਲਿਮਿਟ ਹੁੰਦੀ ਹੈ (10-120 ਬੇਨਤੀਆਂ ਪ੍ਰਤੀ ਮਿੰਟ)। ਸੀਮਾ ਤੋਂ ਵੱਧ API ਇੱਕ Retry-After ਹੈਡਰ ਨਾਲ 429 ਦਾ ਜਵਾਬ ਦਿੰਦਾ ਹੈ।
• ਐਲਆਈ ਟੈਕਸਟ ਜਨਰੇਸ਼ਨ ਲਈ ਪਬਲਿਕ ਕੀਮਤ ਸੂਚੀ ਦੇ ਅਨੁਸਾਰ ਫੀਸ ਲਿਆਂਦੀ ਜਾਂਦੀ ਹੈ: ਪਹਿਲਾਂ ਤੁਹਾਡੀ ਮਹੀਨਾਵਾਰ ਐਲਆਈ ਭੱਤਾ ਤੋਂ, ਫਿਰ ਤੁਹਾਡੇ ChatGetz ਬੈਲੇਂਸ ਤੋਂ।
• Send an Idempotency-Key header with AI requests: a retried request with the same key is never charged twice.

ਐਂਡਪੁਆਇੰਟਸ

• 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. ਵੱਲ ਲੈ ਜਾਂਦੀਆਂ ਹਨ ਇੱਕੋ ਸਰੋਤ, ਕਿਸਮ ਅਤੇ 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 ਕੁੰਜੀ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹਨ। ਕੁੰਜੀ ਪਲੱਗਇਨ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਸੰਭਾਲੀ ਜਾਂਦੀ ਹੈ, ਕਦੇ ਵੀ ਕੋਡ ਵਿੱਚ ਨਹੀਂ।