Kendi CMS'inize doğrudan taslak çekin

Reçete: Başka bir CMS'e taslak çekmek

Aşağıdaki senaryoda; sunucunuzda dakikada bir çalışan bir cron job vardır, son 5 dakikada onaylanmış (status=approved) taslakları çeker, kendi CMS'inizin draft koleksiyonuna yazar.

Adım 1 — Token'ı bir kere üretin

# Interaktif; sonucu bir yere kaydedin
curl -sS -X POST https://newsmachine.umutozan.dev/api/v1/tokens \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"***","name":"cms-sync"}'

Adım 2 — Onaylı taslakları çekin

curl -sS "https://newsmachine.umutozan.dev/api/v1/articles?status=approved&per_page=50&from=$(date -u -v-5M '+%Y-%m-%dT%H:%M:%SZ')" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' | jq

Adım 3 — Her taslak için kendi CMS'inize post edin

Response içinde headline, spot, body, hero_image_url, tags, category, source_urls alanları bulunur. Bunları kendi CMS API'nize dönüştürün. Örnek Node script:

import fetch from 'node-fetch';

const AJANS = 'https://newsmachine.umutozan.dev/api/v1';
const CMS   = 'https://my-cms.example.com/api';

async function sync() {
  const since = new Date(Date.now() - 5*60*1000).toISOString();
  const res = await fetch(`${AJANS}/articles?status=approved&per_page=50&from=${since}`, {
    headers: { Authorization: `Bearer ${process.env.AJANS_TOKEN}` }
  });
  const { data } = await res.json();

  for (const a of data) {
    await fetch(`${CMS}/drafts`, {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${process.env.CMS_TOKEN}`, 'Content-Type': 'application/json' },
      body: JSON.stringify({
        externalId: `ajans11-${a.id}`,
        title: a.headline,
        excerpt: a.spot,
        html: a.body,
        heroImage: a.hero_image_url,
        tags: a.tags,
        category: a.category,
        sources: a.source_urls,
      })
    });
  }
}
sync().catch(console.error);

Filtreler

GET /articles parametreleri:

• status — draft, needs_review, approved, published, rejected
• category — slug: gundem, ekonomi, spor, teknoloji, …
• from / to — ISO tarih (generated_at aralığı)
• q — başlıkta LIKE arama
• page / per_page — sayfalama (max per_page=100)

Pratik notlar

• Rate limit: 60/dk/user. Cron aralığınızı ona göre planlayın.
• Yanıtlar sayfalıdır; büyük tarih aralıkları için page'i döndürerek okuyun.
• Body Markdown veya sade HTML formatındadır — kendi CMS'iniz için sanitizer geçirmeyi unutmayın.
• Kaynaklara referans göstermek için source_urls dizisini yazının altında listeleyebilirsiniz.

Pull yerine push: Webhook

Cron'la sık çekme yerine sunucunuz canlıysa webhook ile push almak daha verimlidir. Detaylar için ana geliştirici sayfası.

← Tüm geliştirici kaynakları