Entegrasyon kiti

Yazar Haber Ajansı'nın içeriğini kendi haber sitenize ya da haber yazılımınıza bağlamak için gereken her şey: hangi yolu seçeceğiniz, kabul ölçütleri, başvuru bağlayıcıları, webhook ve klasör alıcıları, sınama aracı, örnek dosyalar ve şemalar. Kit herkese açıktır; içeriği almak için ise bir anahtar ya da çıkış profili gerekir.

Başlarken: dört yol

Yol	Ne zaman	Nasıl	Kılavuz
WordPress eklentisi	Siteniz WordPress ile çalışıyorsa	YHA Abone'den kurulum kodu alın, eklentiyi kurun, kodu yapıştırın	WordPress
Hazır bağlantı	Haber yazılımınız bir klasörden NewsML-G2, NITF, IPTC 7901, ajans XML'i ya da JSON okuyorsa; HTTPS bildirimi alabiliyorsa; RSS okuyorsa	YHA Abone'nin sihirbazında hazır ayarı seçin; ajans dosyaları sizin FTP/SFTP sunucunuza ya da ajansın FTP kutusuna yazar	Hazır bağlantılar
Kendi bağlantınız (API)	Yazılımınızı kendiniz geliştiriyorsanız ya da hazır bağlantılardan hiçbiri uymuyorsa	API anahtarıyla akıştan çekin; bu kitteki başvuru bağlayıcısını şablon alın	Kendi yazılımımız
YHA Abone'nin klasörü	Yazılımınız yerel bir klasörü okuyabiliyorsa ve terminal açık kalıyorsa	Terminalin otomatik indirme klasörünü yazılımınıza gösterin	Terminal klasörü

Hangi yolu seçerseniz seçin, bağlantınız denetim listesindeki altı maddeyi karşılamalıdır: Denetim listesi.

Deneme anahtarı

Abone iseniz: YHA Abone · Çıkışlar · Anahtarlar · "Yeni anahtar" → ortam Deneme. Deneme anahtarı (yha_deneme_…) yalnızca https://deneme.<alan>/v1 adresinde ve yalnızca yapay örnek içerikle çalışır.
Haber yazılımı firmasıysanız: Teknik Destek'e başvurun; firmanızı kaydeder ve deneme anahtarını firmanın yetkili e-posta adresine gönderir. Bu anahtar canlı adreste reddedilir (gelistirici_yalnizca_deneme).

Bağlantınızı deneme ortamında bitirdiğinizde uyumluluk sınamasını çalıştırın: altı adım geçerse bağlantınız "uyumlu"dur.

Kitin içindekiler

Parça	Yer	Ne
Denetim listesi	denetim-listesi.md	Altı madde, kabul ölçütleri, sık hatalar
Başvuru bağlayıcısı	`ornekler/{python,javascript,php,csharp}/baglayici/`	Akış → yerel içerik: imleç, tekrar ayıklama, düzeltme, iptal, embargo, kaynak notu, medya, durum bildirimi, sınama raporu
Webhook alıcısı	`ornekler/{python,javascript,php,csharp}/webhook-alici/`	İmza, zaman damgası, `webhook-id`, "dürt ve çek"; alıcı denetimini geçer
Klasör alıcısı	`ornekler/python/klasor-alici/`	Klasör izleyen haber yazılımı benzeticisi; NewsML-G2, NITF, IPTC 7901, ajans XML'i ve JSON okur
Sınama aracı	`ornekler/python/yha-sinama/yha_sinama.py`	Uyumluluk sınamasını terminalden yürütür, rapor yazar
Örnek dosyalar	`ornek-dosyalar/`	Sunucunun sınama dosyalarından üretilen örnekler (yeni, düzeltme, iptal, embargo, tanıtım, flaş; her kodlama)
Şemalar	`semalar/`	Ajans XML şeması, NITF ve IPTC 7901 profil belgeleri
Postman	`postman/yha-dis-v1.json`	OpenAPI belgesinden üretilen derleme

Örnekler yalnızca dillerin standart kitaplığını kullanır (Python 3.10+, Node.js 18+, PHP 8.1+, .NET 8); hiçbirinde çerçeve ya da paket yoktur. Varsayılan kök deneme ortamıdır (YHA_KOK); kendi kodunuza taşırken anahtarı ortam değişkeninden ya da sır deposundan okuyun, koda yazmayın.

Örnekleri çalıştırmak

bash

# Python: başvuru bağlayıcısı (bir kez çek, durum bildir)
YHA_ANAHTAR=yha_deneme_... python ornekler/python/baglayici/baglayici.py --tek-sefer

# Webhook alıcısı (önüne TLS sonlandıran bir vekil koyun)
YHA_WEBHOOK_SIRRI=whsec_... YHA_ANAHTAR=yha_deneme_... python ornekler/python/webhook-alici/webhook_alici.py

# Klasör alıcısı: ajansın dosya yazdığı klasörü izler
python ornekler/python/klasor-alici/klasor_alici.py /veri/ajans --onizleme onizleme.html

# Uyumluluk sınaması
python ornekler/python/yha-sinama/yha_sinama.py --anahtar yha_deneme_... --yayin taslak

Her örneğin yanında kendi sınaması vardır (python -m unittest, node --test ornekler.test.mjs, php ornekler-sinama.php, dotnet run -- --oz-sinama); sahte bir API'ye karşı çalışır, ağ gerektirmez.

Durum bildirimi

Bağlantınızın çalıştığını ajansın da görmesi için döngü sonunda PUT /v1/entegrasyon çağırın (önerilir). Gövde site adresi, yazılım sürümü, sayaçlar ve son hataları taşır; kişi verisi taşımaz. Yanıt bir sonraki bildirim aralığını (sonraki_bildirim_saniye) ve varsa uyarıları söyler. Ayrıntı: API başvurusu.