AI Entegrasyonu

2328.io dokümantasyonu LLM-friendly olarak hazırlanmıştır. Tüm API referansını herhangi bir modern AI asistanına verebilir ve seçtiğiniz dilde — PHP, Node.js, Python, Go, Rust — saatler yerine dakikalar içinde çalışan bir entegrasyon ürettirebilirsiniz.

Bu sayfa, bunu nasıl verimli şekilde yapacağınızı anlatır.

Entegrasyon için neden AI kullanmalı

• Daha hızlı başlangıç — boilerplate'i atlayın, doğrudan iş mantığına geçin
• Doğru imzalama — AI, herhangi bir dilde HMAC-SHA256 imzalamayı güvenilir biçimde yeniden üretir
• Webhook handler'ları — imza doğrulaması ve idempotent handler'ları kutudan çıktığı gibi üretin
• Güncel — llms-full.txt dosyamız her doküman güncellemesinde yeniden üretilir, böylece her zaman güncel şemaları alırsınız

Makine tarafından okunabilir dokümanlar

llmstxt.org standardına uygun üç endpoint yayınlıyoruz:

Her HTML sayfası ayrıca Markdown sürümüne işaret eden <link rel="alternate" type="text/markdown"> etiketini de açığa çıkarır, böylece AI tarayıcıları bunu otomatik olarak keşfeder.

Claude veya ChatGPT ile hızlı başlangıç

Adım 1 — Dokümanları sağlayın

Yeni bir sohbet açın ve llms-full.txt içeriğini ilk mesajınız olarak yapıştırın; ya da model bağlantıyı çekebiliyorsa sadece bağlantıyı paylaşın.

Adım 2 — Stack'inizi tanımlayın

Asistana ne inşa ettiğinizi söyleyin:

I'm building a Laravel 11 application. I need to:
1. Create a payment for an order (amount in USD, user pays in USDT TRC20)
2. Handle the webhook and credit the user's balance
3. Store payment records in a `payments` table

Use the 2328.io API above. Include HMAC signing, webhook signature
verification, and idempotency.

Adım 3 — Gözden geçirin ve test edin

Asistan bir controller, bir service sınıfı ve bir webhook handler üretecektir. Yayına almadan önce:

• apiSign()'ın gövdeyi HMAC-SHA256'dan önce Base64 ile encode ettiğini doğrulayın
• Webhook handler'larının imzaları karşılaştırırken hash_equals() (değil ===) çağırdığını kontrol edin
• Handler'ın idempotent olduğundan emin olun — alacaklandırmadan önce order_id / txid kontrol edin
• Önce dev ortamda küçük bir gerçek ödeme ile test edin

IDE entegrasyonları

Cursor

Cursor ayarlarında dokümanları özel doküman kaynağı olarak ekleyin:

Settings → Features → Docs → Add new doc
URL: https://doc.2328.io

Ardından sohbette sorunuzun başına @2328.io ekleyin:

@2328.io generate a webhook handler in Next.js App Router
with signature verification and idempotent credit logic

GitHub Copilot

Copilot Chat, llms-full.txt'yi doğrudan okuyabilir:

#fetch https://doc.2328.io/llms-full.txt

Using the 2328.io API docs above, implement a payout endpoint
in Express that withdraws USDT BEP20 to a user-supplied address.

Windsurf / Continue / diğer asistanlar

URL bağlamı veya dosya eki destekleyen herhangi bir asistan aynı şekilde çalışır — llms-full.txt'yi ekleyin ve hedefinizi tanımlayın.

Claude API (Agent SDK)

2328.io ile etkileşim kurması gereken kendi agent veya chatbot'unuzu inşa ediyorsanız, dokümanları system prompt'a bir kez enjekte edin:

from anthropic import Anthropic
import urllib.request

docs = urllib.request.urlopen(
    "https://doc.2328.io/llms-full.txt"
).read().decode()

client = Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=4096,
    system=f"""You are an integration assistant for 2328.io.
Use the API reference below to answer questions and generate code.

<docs>
{docs}
</docs>""",
    messages=[
        {"role": "user", "content": "Write a Python function that creates a USDT payment"}
    ],
)

print(response.content[0].text)

İyi sonuç veren örnek prompt'lar

llms-full.txt'yi paylaştıktan sonra Claude, ChatGPT veya AI IDE'nize bunları kopyalayın:

Tam backend entegrasyonu:

Build a Node.js + Express service that exposes two routes:
- POST /checkout → creates a 2328.io payment and returns the payment URL
- POST /webhook/2328 → verifies the signature and marks the order as paid
Use TypeScript, Zod for validation, and a simple in-memory store.

Çekim aracı:

Write a CLI in Go that takes a currency, network, amount, and address
and creates a payout via the 2328.io Payout API. Use a separate payout
API key from env. Poll the status endpoint until the payout is completed.

Kullanıcı yatırımları için statik cüzdan:

I have a Django app where users deposit USDT TRC20 to top up their balance.
Each user should have a permanent deposit address. Implement this using
2328.io static wallets, including the webhook handler that credits their
balance when a deposit arrives.

AI destekli entegrasyon için en iyi uygulamalar

• llms-full.txt'den başlayın — LLM context için tasarlandı, boilerplate yok
• Stack'iniz hakkında spesifik olun — framework, dil sürümü, ORM
• Test isteyin — AI, imzalama mantığı için unit testler üretmede iyidir
• Hata yönetimini iki kez kontrol edin — AI bazen başarısızlık yollarını atlar
• İmza kodunu manuel olarak gözden geçirin — kesinlikle doğru olması gereken tek kısım budur
• Düzenli olarak yenileyin — API'miz değişirse, llms-full.txt'yi yeniden alın ve yeniden prompt edin