Başlarken

Yazar Haber Ajansı aboneleri haberleri, fotoğrafları ve videoları kendi yazılımlarına birkaç yoldan alabilir:

Yol	Adres	Ne zaman
Abone API'si	`https://api.<alan>/v1`	Kendi yazılımınız akışı imleçle çeker (Akış ve imleç)
Anlık akış (SSE)	`https://api.<alan>/v1/olaylar`	Servis edilen her içerik saniyeler içinde gelsin (Anlık akış)
Webhook	Sizin `https` adresiniz	Biz size gönderelim (Webhook)
FTP, FTPS, SFTP	Sizin sunucunuz ya da ajans FTP sunucusu	Klasör izleyen haber yazılımları (FTP ve SFTP)
RSS ve Atom	`https://rss.<alan>/b/<kod>/<etiket>.xml`	Okuyucu ve basit siteler (RSS)
E-posta	Alıcı adresleriniz	Tek tek ya da bülten (E-posta)
MCP	`https://mcp.<alan>/`	Yapay zekâ istemcileri (MCP)

Hangi yolların açık olduğu paketinize bağlıdır; açık olmayan yol 403 kanal_paketinde_yok döner. İçerik her yolda paketinizin hakkıyla sınırlıdır.

1. Anahtar üretin

YHA Abone · Çıkışlar · Anahtarlar ekranından "Anahtar üret" deyin. Önce deneme ortamı için yha_deneme_… anahtarı üretmenizi öneririz: deneme ortamı yapay örnek içerik verir, aboneliğiniz denemedeyken bile çalışır (Deneme ortamı). Anahtar yalnızca bir kez gösterilir; güvenli bir yere kaydedin.

2. İlk isteği gönderin

bash

export YHA_ANAHTAR=yha_deneme_...
curl -s "https://deneme.<alan>/v1/ben" -H "Authorization: Bearer $YHA_ANAHTAR"
curl -s "https://deneme.<alan>/v1/akis?boyut=10" -H "Authorization: Bearer $YHA_ANAHTAR"

3. Canlıya geçin

Canlı anahtar (yha_canli_…) için kurumunuz adına API kullanım şartları bir kez onaylanır. Kök adres https://api.<alan> olur; istekler ve yanıtlar deneme ortamıyla aynıdır.

Temel kurallar

Bütün istekler GET'tir; gövde JSON, UTF-8, zamanlar ISO 8601 UTC.
Aynı olay iki kez gelebilir: olay_id ile ayıklayın, düzeltmeyi surum_no ile uygulayın.
Yanıttaki bilinmeyen alanları ve bilinmeyen sayım değerlerini yok sayın (geriye uyumlu eklemelerdir).
İptal edilen haberi yayından kaldırın: iptal dolu gelir, govde boştur.
Tanıtım içeriği tanitim: true taşır; tercihiniz kapalıysa hiç gelmez.
Tarayıcıdan (CORS) istek kabul edilmez; anahtar sunucunuzda kalmalıdır.
Hata kodları için Hatalar, sınırlar için Sınırlar, API başvurusu için API başvurusu.