Yapay zekâ ajanları için

Bu API'yi bir yapay zekâ ajanına (Claude, ChatGPT, Cursor, kendi ajanınız) kullandıracaksanız ihtiyacı olan her şey makinenin okuyacağı biçimde hazır.

Kaynaklar

Adres	İçerik
/llms.txt	Kısa dizin: kurallar, rehberler, bütün uçlar tek satırda
/llms-full.txt	Rehberler ve her ucun ayrıntısı (şema, hata kodu, örnek) tek dosya
/openapi.tr.json	OpenAPI 3.1 — araç tanımı üretmek için
/md/<sayfa>.md	Her rehberin düz Markdown kopyası

İngilizce karşılıkları: /llms.en.txt, /llms-full.en.txt, /openapi.en.json.

OpenAPI belgesindeki her uç şu uzantıları taşır:

• x-ug-role — hangi anahtar rolü çağırabilir (customer, usta, any)
• x-ug-scope — gereken izin (read, write, money)
• x-ug-error-codes — dönebilecek hata kodları
• x-ai-hint — varsa ajana kısa bir ipucu

Hazır talimat

Ajanınızın sistem talimatına ekleyebilirsiniz:

UstaGeliyor Partner API'sini kullanıyorsun. Tanım: <DOCS>/llms-full.txt
Temel adres: <API>/partner/v1. Her isteğe "Authorization: Bearer <ANAHTAR>" ekle.
Kurallar:
- Hizmet ve paket kimliklerini GET /catalog'dan al; fiyat ve başlık gönderme.
- Müşteriye tutarı POST /pricing/preview ile göster.
- Hata olursa "code" alanına göre karar ver; mesajı kullanıcıya aktarabilirsin.
- Ödeme açmak, işi onaylamak, iade ve itiraz gibi "money" izni isteyen
  işlemleri yalnızca kullanıcı açıkça onayladıktan sonra çağır.
- Kart bilgisi isteme ya da gönderme; kart ödemesi için payment.payment_url
  adresini kullanıcıya ver.
- Durum değişikliklerini GET /notifications/sync ile yokla.

Güvenlik

• Anahtarı ajanın kendisine değil, ajanın çağırdığı araca (sunucu tarafındaki bir fonksiyona) verin; model çıktısında anahtar görünmesin.
• Ajan için en az izinli anahtarı isteyin: yalnızca bilgi verecekse read.
• Her çağrı ekibin panelindeki günlükte anahtar adıyla görünür; ajana ayrı bir anahtar açtırmak, onun yaptıklarını ayırmayı kolaylaştırır.