Ajanınızı bağlayın

Üç adım

1. 1

   Anahtar oluşturun

   Anahtarı aileden bir yetişkin oluşturur — tam burada. Giriş yapın, bu forma geri dönersiniz.

   Giriş yap ve anahtar oluştur
2. 2

   Skill’i kurun

   Skill, ajana rotaları ve adımların sırasını öğretir. Komut çalıştırabilen ajanlara uygundur: Claude Code, Cursor, OpenClaw ve benzerleri.

3. 3

   İsteyin

   “Çocukların bugün nesi var?”, “İşaretledikleri her şeyi onayla”, “Efe için görev ekle — çarşambaları çöpü çıkarmak, 10 puan”.

Skill

İlk komut skill’i kurar, diğerleri anahtarı skill’in aradığı yere koyar. Anahtarı ajanın sohbetine yapıştırmanız gerekmez. github.com/usavilov/questburg-skills

npx -y skills add usavilov/questburg-skills
mkdir -p ~/.config/questburg
printf '%s' 'qb_…' > ~/.config/questburg/key
chmod 600 ~/.config/questburg/key

API

Skill size uymuyorsa aynı API doğrudan açık. Anahtar başlıkta gönderilir, yanıtlar JSON biçimindedir.

https://questburg.com/api/v1

Ajana tek bir adres verebilirsiniz — orada aynı bilgiler onun için yazılmış: questburg.com/llms.txt

• GET/me

  Aile, kodları ve puanlarıyla üyeler, anahtarın yetkileri.

• GET/today

  Günün işleri. ?member=kod — tek üye, ?date=YYYY-AA-GG — başka bir gün.

• GET/approvals

  Çocukların işaretledikleri ve yanıtınızı bekleyenler.

• POST/occurrences/{id}/done

  İşi yapıldı olarak işaretler.

• POST/occurrences/{id}/approve

  Onaylar: puanlar eklenir. Kapanmış gün — bir hafta içinde.

• POST/occurrences/{id}/reject

  İşareti reddeder.

• POST/approvals/approve-all

  Çocukların işaretlediği her şeyi onaylar.

• GET/offers

  Geçerli görevler.

• POST/offers

  Görev ekler: title, assignees (kodlar ya da "kids"), points, weekdays.

• PATCH/offers/{code}

  Görevi değiştirir: yalnızca değişeni gönderin.

• DELETE/offers/{code}

  Görevi kaldırır. Geçmiş kalır.

• POST/occurrences/{id}/undo

  Onayı geri alır: puanlar geri döner, iş yeniden yanıt bekler.

• GET/starters

  Hazır işler ve ödüller; first — nereden başlamalı. POST { key } — çocuklara iş, { reward } — ödül ekler.

• GET/rewards

  Hediyeler. POST — ekler: title ve price ya da streak { quest, days }.

• PATCH/rewards/{code}

  Hediyeyi değiştirir; DELETE — kaldırır.

• GET/redemptions

  Yanıt bekleyen hediye istekleri.

• POST/redemptions/{id}/grant

  Hediye verildi; /refuse — ret.

• GET/gates

  İzinler ve bugün hangi çocukların açtığı. POST — ekler: name, quests, price.

• PATCH/gates/{code}

  İzni değiştirir; DELETE — kaldırır.

• POST/gates/{code}/override

  Bugünlük izin verir ya da kapatır: member, state (granted | blocked), note.

• GET/members/{code}

  Üye sayfası: bakiye, seriler, son günler, izinler, ihlaller.

• POST/members/{code}/points

  Puan ekler ya da düşer: delta, note.

• GET/strikes

  İhlal türleri. POST — ekler: title, penalty; koda göre PATCH ve DELETE.

• POST/strikes/{code}/log

  İhlali kaydeder: member, note. Ceza hemen düşülür.

• GET/stats

  Dönem raporu: ?days=7, 30 ya da 90.

• GET/feed

  Ailenin etkinlik akışı.

export QUESTBURG_API_KEY=qb_…
curl -s -H "Authorization: Bearer $QUESTBURG_API_KEY" https://questburg.com/api/v1/me

curl -s -X POST https://questburg.com/api/v1/offers \
  -H "Authorization: Bearer $QUESTBURG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Take out the trash", "assignees": "kids", "points": 10, "weekdays": [3]}'

Bilmeniz gerekenler

• Anahtar, onu oluşturan yetişkin adına çalışır: ajanın onayladıkları o yetişkinin adına kaydedilir.
• Anahtar şifrelere, giriş kodlarına ve davetlere erişemez. Kaldırılan görev, hediye ya da izin arşive gider — geçmiş kalır.
• İşaretleme ya da onay isteğini tekrarlamak güvenlidir: puanlar ikinci kez eklenmez.
• Sınır — anahtar başına dakikada 60 istek. Aşılırsa 429 döner.
• Hata her zaman aynı biçimdedir: { error: { code, message } }.
• Anahtarı oluşturduğunuz yerden iptal edebilirsiniz. Erişim hemen kesilir.