Yapay Zeka Reaksiyonları

Yapay zeka çalıştırmalarına ve mesajlarına 10 reaksiyon türüyle tepki verin. Reaksiyonlar geçiş anlambilimini kullanır; aynı uç nokta bir reaksiyonu ekler veya kaldırır.

Uç noktalar

Method	Path	Description	Auth	Rate Limit
POST	`/ai/reactions/toggle`	Toggle a reaction	JWT + Entitlement	30/min
GET	`/ai/reactions/runs/:runId`	Get reactions for a run	JWT + Entitlement	60/min
GET	`/ai/reactions/messages/:messageId`	Get reactions for a message	JWT + Entitlement	60/min
GET	`/ai/reactions/runs/:runId/stats`	Aggregate stats for a run	JWT + Entitlement	60/min
GET	`/ai/reactions/messages/:messageId/stats`	Aggregate stats for a message	JWT + Entitlement	60/min
DELETE	`/ai/reactions/:id`	Remove a reaction by ID	JWT + Entitlement	30/min

Reaksiyon Türleri

Type	Description
`like`	General positive signal
`dislike`	General negative signal
`accurate`	Factually correct
`creative`	Novel or surprising
`fast`	Quick response
`helpful`	Directly useful
`inspiring`	Motivating content
`confusing`	Hard to understand
`wrong`	Factually incorrect
`slow`	Response took too long

POST /ai/reactions/toggle

Bir çalıştırma veya mesajdaki reaksiyonu değiştirin. Reaksiyon zaten mevcutsa kaldırılır. Eğer mevcut değilse eklenir.

Kimlik Doğrulama: JWT Taşıyıcı jetonu + aktif AI yetkisi gereklidir. Hız sınırı: 30/dak

Rica etmek

Field	Type	Required	Description
`reactionType`	string	Yes	One of the 10 reaction types
`runId`	string	No	Target run ID
`messageId`	string	No	Target message ID
`comment`	string	No	Optional comment (max 1000 chars, only for `like`/`dislike`)

Cevap

Yanıt Örneği (Eklendi)

json

{
  "data": {
    "action": "added",
    "reaction": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "chainerId": "u1234567-abcd-ef01-2345-6789abcdef00",
      "reactionType": "helpful",
      "comment": null,
      "createdAt": "2026-03-17T14:00:00.000Z"
    }
  }
}

Yanıt Örneği (Kaldırıldı)

json

{
  "data": {
    "action": "removed"
  }
}

Yanıt Alanları

Field	Type	Description
`action`	`"added"` \| `"removed"`	Whether the reaction was created or deleted
`reaction`	object \| undefined	The created reaction (only when `action` is `"added"`)
`reaction.id`	string	Reaction UUID
`reaction.chainerId`	string	User who reacted
`reaction.reactionType`	string	The reaction type
`reaction.comment`	string \| null	Optional comment
`reaction.createdAt`	string	ISO 8601 timestamp

Kod Örnekleri

Mevcut bir AI çalışmasının "kimliğini" "$RUN_ID" olarak kullanın.

cURLJavaScriptPython

bash

curl -X POST https://api.chainabit.com/api/v1/ai/reactions/toggle \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reactionType": "helpful",
    "runId": "'"$RUN_ID"'"
  }'

javascript

const runId = process.env.RUN_ID; // id of the AI run you're reacting to

const res = await fetch(`${BASE_URL}/ai/reactions/toggle`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    reactionType: "helpful",
    runId,
  }),
});
const { data } = await res.json();

python

import os
import requests

run_id = os.environ["RUN_ID"]  # id of the AI run you're reacting to

res = requests.post(
    f"{BASE_URL}/ai/reactions/toggle",
    headers={"Authorization": f"Bearer {TOKEN}"},
    json={
        "reactionType": "helpful",
        "runId": run_id,
    },
)
data = res.json()["data"]

GET /ai/reactions/runs/:runId

Bir çalıştırma için toplu reaksiyon istatistiklerini ve mevcut kullanıcının reaksiyonlarını alın.

Kimlik Doğrulama: JWT Taşıyıcı jetonu + aktif AI yetkisi gereklidir. Hız sınırı: 60/dak

Rica etmek

Yol parametreleri: runId

Cevap

Yanıt Örneği

json

{
  "data": {
    "stats": [
      { "reactionType": "helpful", "count": 12 },
      { "reactionType": "accurate", "count": 8 },
      { "reactionType": "like", "count": 5 }
    ],
    "userReactions": ["helpful", "like"]
  }
}

Yanıt Alanları

Field	Type	Description
`stats`	array	Aggregate counts per reaction type, sorted by count descending
`stats[].reactionType`	string	Reaction type name
`stats[].count`	number	Total reactions of this type
`userReactions`	string[]	Reaction types the current user has applied

Kod Örnekleri

Mevcut bir AI çalışmasının "kimliğini" "$RUN_ID" olarak kullanın.

cURLJavaScriptPython

bash

curl https://api.chainabit.com/api/v1/ai/reactions/runs/$RUN_ID \
  -H "Authorization: Bearer $TOKEN"

javascript

const runId = process.env.RUN_ID; // id of the AI run

const res = await fetch(
  `${BASE_URL}/ai/reactions/runs/${runId}`,
  { headers: { Authorization: `Bearer ${TOKEN}` } }
);
const { data } = await res.json();

python

import os
import requests

run_id = os.environ["RUN_ID"]  # id of the AI run

res = requests.get(
    f"{BASE_URL}/ai/reactions/runs/{run_id}",
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()["data"]

GET /ai/reactions/runs/:runId/stats

Kullanıcıya özel veriler olmadan bir çalıştırmanın toplam reaksiyon sayılarını alın.

Kimlik Doğrulama: JWT Taşıyıcı jetonu + aktif AI yetkisi gereklidir. Hız sınırı: 60/dak

Rica etmek

Yol parametreleri: runId

Cevap

Yanıt Örneği

json

{
  "data": {
    "stats": [
      { "reactionType": "helpful", "count": 12 },
      { "reactionType": "accurate", "count": 8 }
    ],
    "userReactions": []
  }
}

Kod Örnekleri

Mevcut bir AI çalışmasının "kimliğini" "$RUN_ID" olarak kullanın.

cURLJavaScriptPython

bash

curl https://api.chainabit.com/api/v1/ai/reactions/runs/$RUN_ID/stats \
  -H "Authorization: Bearer $TOKEN"

javascript

const runId = process.env.RUN_ID; // id of the AI run

const res = await fetch(
  `${BASE_URL}/ai/reactions/runs/${runId}/stats`,
  { headers: { Authorization: `Bearer ${TOKEN}` } }
);
const { data } = await res.json();

python

import os
import requests

run_id = os.environ["RUN_ID"]  # id of the AI run

res = requests.get(
    f"{BASE_URL}/ai/reactions/runs/{run_id}/stats",
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()["data"]

DELETE /ai/reactions/:id

Belirli bir reaksiyonu kimliğine göre kaldırın. Yalnızca reaksiyon sahibi bunu silebilir.

Kimlik Doğrulama: JWT Taşıyıcı jetonu + aktif AI yetkisi gereklidir. Hız sınırı: 30/dak

Rica etmek

Yol parametreleri: "kimlik"

Cevap

Yanıt Örneği

json

{
  "data": {
    "deleted": true
  }
}

Kod Örnekleri

Toggle Reaction'ın "eklenen" yanıtındaki (data.reaction.id) kimliğini $REACTION_ID olarak kullanın.

cURLJavaScriptPython

bash

curl -X DELETE https://api.chainabit.com/api/v1/ai/reactions/$REACTION_ID \
  -H "Authorization: Bearer $TOKEN"

javascript

const reactionId = process.env.REACTION_ID; // id from the "added" response of POST /ai/reactions/toggle

const res = await fetch(
  `${BASE_URL}/ai/reactions/${reactionId}`,
  {
    method: "DELETE",
    headers: { Authorization: `Bearer ${TOKEN}` },
  }
);
const { data } = await res.json();

python

import os
import requests

reaction_id = os.environ["REACTION_ID"]  # id from the "added" response of POST /ai/reactions/toggle

res = requests.delete(
    f"{BASE_URL}/ai/reactions/{reaction_id}",
    headers={"Authorization": f"Bearer {TOKEN}"},
)
data = res.json()["data"]

Yapay Zeka Reaksiyonları ​

Uç noktalar ​

Reaksiyon Türleri ​

POST /ai/reactions/toggle ​

Rica etmek ​

Cevap ​

Yanıt Örneği (Eklendi) ​

Yanıt Örneği (Kaldırıldı) ​

Yanıt Alanları ​

Kod Örnekleri ​

GET /ai/reactions/runs/:runId ​

Rica etmek ​

Cevap ​

Yanıt Örneği ​

Yanıt Alanları ​

Kod Örnekleri ​

GET /ai/reactions/runs/:runId/stats ​

Rica etmek ​

Cevap ​

Yanıt Örneği ​

Kod Örnekleri ​

DELETE /ai/reactions/:id ​

Rica etmek ​

Cevap ​

Yanıt Örneği ​

Kod Örnekleri ​

Yapay Zeka Reaksiyonları

Uç noktalar

Reaksiyon Türleri

POST /ai/reactions/toggle

Rica etmek

Cevap

Yanıt Örneği (Eklendi)

Yanıt Örneği (Kaldırıldı)

Yanıt Alanları

Kod Örnekleri

GET /ai/reactions/runs/:runId

Rica etmek

Cevap

Yanıt Örneği

Yanıt Alanları

Kod Örnekleri

GET /ai/reactions/runs/:runId/stats

Rica etmek

Cevap

Yanıt Örneği

Kod Örnekleri

DELETE /ai/reactions/:id

Rica etmek

Cevap

Yanıt Örneği

Kod Örnekleri