İçerik üret

POST

POST https://api.aldinc.co/v1/content/generate

Bir brief gönder, GEO-uyumlu içerik üret. 5 aşamalı pipeline çalışır: Research → Outline → Draft → Self-critique → Schema. İşlem asenkron, webhook ile sonuç dönülür.

Headers

Authorizationzorunlu

stringBearer YOUR_API_KEY

Content-Typezorunlu

stringapplication/json

X-Idempotency-Key

stringAynı brief'in iki kez üretimini engeller

Request Body

website_idzorunlu

uuidHedef site UUID'si

briefzorunlu

objectİçerik briefi (zorunlu)

brief.target_keywordzorunlu

stringBirincil anahtar kelime

brief.intent

stringinformational | transactional | commercial

brief.word_count

object{ min: number, max: number }

brief.tone

stringprofesyonel | samimi | teknik | otoriter

model

stringclaude-3-5-sonnet | gemini-1.5-pro | gpt-4-turbo

niche

locale

stringVarsayılan: tr

Response (202 Accepted)

id

uuidİçerik ID'si

status

stringqueued | generating | ready | failed

estimated_completion

datetimeISO 8601, ortalama ~120 sn

webhook_url

stringSonuç bu URL'e POST edilir (varsa)

Hatalar

400

invalid_brief

Brief eksik veya geçersiz alanlar var.

401

unauthorized

API token geçersiz veya süresi dolmuş.

402

quota_exceeded

Aylık içerik kotası dolmuş. Upgrade gerekiyor.

429

rate_limited

Saniyede 5 istek limiti aşıldı.

503

llm_unavailable

LLM sağlayıcı geçici olarak erişilemez.