PDF Raporları

Doğum haritaları, sinastri, güneş dönüşleri ve daha fazlası için profesyonel PDF raporları oluşturun. PDF Raporları modülü, yorumlar, haritalar ve tablolar içeren özelleştirilebilir astroloji raporları oluşturmanıza olanak tanır.

Genel Bakış

PDF Raporları özelliği şunları sağlar:

Çoklu rapor türleri: Natal, sinastri, kompozit, geçiş, güneş dönüşü, ay dönüşü, ilerlemeler, numeroloji ve Çin astrolojisi
Özelleştirilebilir şablonlar: Özel düzenlerle kendi PDF şablonlarınızı oluşturun ve yönetin
Otomatik hesaplamalar: Astroloji verileri anında hesaplanır ve şablonunuza birleştirilir
Profesyonel çıktı: Üstbilgiler, altbilgiler, sayfa numaraları ve özel CSS desteğiyle yüksek kaliteli PDF oluşturma

Desteklenen Rapor Türleri

Rapor Türü	Açıklama
`natal`	Gezegen konumları, evler ve açılarla doğum haritası analizi
`synastry`	İki harita arasında ilişki uyumluluğu
`composite`	İlişkiler için birleşik harita
`transit`	Natal haritaya mevcut gezegen geçişleri
`solar-return`	Yıllık doğum günü haritası
`lunar-return`	Aylık ay dönüşü haritası
`progressions`	İkincil ilerlemeler
`numerology`	Numeroloji hesaplamaları ve analizi
`chinese`	Çin astrolojisi raporu

PDF Raporu Oluşturma

Doğum verilerini sağlayarak ve isteğe bağlı olarak bir şablon belirterek PDF raporu oluşturun.

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "natal",
    "subject": {
      "name": "John Doe",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    }
  }' \
  --output natal-report.pdf

İstek Parametreleri

Parametre	Tür	Zorunlu	Açıklama
`reportType`	string	Evet	Rapor türü (yukarıdaki desteklenen türlere bakın)
`templateId`	string	Hayır	Kullanılacak belirli şablon ID'si (belirtilmezse varsayılanı kullanır)
`subject`	object	Evet	Ana kişi için doğum verileri
`partner`	object	Hayır	Partner için doğum verileri (sinastri/kompozit için gerekli)
`transitDate`	object	Hayır	Geçiş/dönüş raporları için hedef tarih

Kişi Nesnesi

Alan	Tür	Zorunlu	Açıklama
`name`	string	Evet	Kişinin adı
`birthDate`	object	Evet	Doğum tarihi ve saati
`birthDate.year`	number	Evet	Doğum yılı
`birthDate.month`	number	Evet	Doğum ayı (1-12)
`birthDate.day`	number	Evet	Doğum günü (1-31)
`birthDate.hour`	number	Evet	Doğum saati (0-23)
`birthDate.minute`	number	Evet	Doğum dakikası (0-59)
`birthPlace`	object	Evet	Doğum yeri
`birthPlace.name`	string	Evet	Konum adı
`birthPlace.latitude`	number	Evet	Enlem (-90 ile 90 arası)
`birthPlace.longitude`	number	Evet	Boylam (-180 ile 180 arası)
`birthPlace.timezone`	string	Evet	IANA saat dilimi tanımlayıcısı

Yanıt

Uç nokta, oluşturulan raporu içeren bir PDF dosyası (application/pdf) döndürür.

Sinastri Raporu Örneği

İki doğum haritasını karşılaştıran bir sinastri raporu oluşturun:

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "synastry",
    "subject": {
      "name": "Person A",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    },
    "partner": {
      "name": "Person B",
      "birthDate": {
        "year": 1988,
        "month": 3,
        "day": 22,
        "hour": 9,
        "minute": 15
      },
      "birthPlace": {
        "name": "Paris, France",
        "latitude": 48.8566,
        "longitude": 2.3522,
        "timezone": "Europe/Paris"
      }
    }
  }' \
  --output synastry-report.pdf

Güneş Dönüşü Raporu Örneği

Belirli bir yıl için güneş dönüşü haritası oluşturun:

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/generate" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "solar-return",
    "subject": {
      "name": "John Doe",
      "birthDate": {
        "year": 1990,
        "month": 6,
        "day": 15,
        "hour": 14,
        "minute": 30
      },
      "birthPlace": {
        "name": "London, UK",
        "latitude": 51.5074,
        "longitude": -0.1278,
        "timezone": "Europe/London"
      }
    },
    "transitDate": {
      "year": 2025,
      "month": 6,
      "day": 15,
      "hour": 0,
      "minute": 0
    }
  }' \
  --output solar-return-2025.pdf

Şablon Yönetimi

Şablonlar, PDF raporlarınızın düzenini ve içeriğini tanımlar. Her şablon belirli bir rapor türüyle ilişkilidir.

Şablonları Listele

bash

curl -X GET "https://api.astroapi.cloud/api/pdf-reports/templates" \
  -H "X-Api-Key: your-api-key"

Hem kuruluşa özel hem de genel (paylaşılan) şablonları döndürür.

Belirli Bir Şablon Al

bash

curl -X GET "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key"

Şablon Oluştur

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "templates",
      "attributes": {
        "name": "My Natal Report Template",
        "description": "Custom natal chart report",
        "reportType": "natal",
        "editorConfig": {},
        "pageSettings": {
          "format": "A4",
          "orientation": "portrait",
          "margins": {
            "top": 20,
            "right": 20,
            "bottom": 20,
            "left": 20
          }
        },
        "isDefault": true
      }
    }
  }'

Şablon Nitelikleri

Nitelik	Tür	Açıklama
`name`	string	Şablon adı (1-100 karakter)
`description`	string	İsteğe bağlı açıklama
`reportType`	string	Bu şablonun hangi rapor türü için olduğu
`editorConfig`	object	Editor.js blok yapılandırması
`pageSettings`	object	Sayfa düzeni ayarları
`customCss`	string	Özel CSS stilleri
`isDefault`	boolean	Bu rapor türü için varsayılan olarak ayarla
`isActive`	boolean	Şablonun etkin olup olmadığı

Sayfa Ayarları

Ayar	Tür	Açıklama
`format`	string	Sayfa boyutu: `"A4"` veya `"Letter"`
`orientation`	string	`"portrait"` veya `"landscape"`
`margins`	object	mm cinsinden sayfa kenar boşlukları (üst, sağ, alt, sol)
`header`	object	Üstbilgi yapılandırması
`footer`	object	Altbilgi yapılandırması
`pageNumbers`	object	Sayfa numarası ayarları

Üstbilgi/Altbilgi Yapılandırması

json

{
  "header": {
    "enabled": true,
    "height": 15,
    "content": "My Astrology Report"
  },
  "footer": {
    "enabled": true,
    "height": 15,
    "content": "Generated by AstroAPI"
  },
  "pageNumbers": {
    "enabled": true,
    "position": "bottom-center",
    "format": "Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span>"
  }
}

Şablon Güncelle

bash

curl -X PATCH "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "templates",
      "attributes": {
        "name": "Updated Template Name"
      }
    }
  }'

Şablon Sil

bash

curl -X DELETE "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}" \
  -H "X-Api-Key: your-api-key"

Şablonu Çoğalt

Mevcut bir şablonu (genel şablonlar dahil) kuruluşunuza kopyalayın:

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}/duplicate" \
  -H "X-Api-Key: your-api-key"

Varsayılan Şablon Ayarla

Bir şablonu rapor türü için varsayılan olarak ayarlayın:

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/templates/{templateId}/set-default" \
  -H "X-Api-Key: your-api-key"

Şablon Önizleme

Örnek verilerle şablonun nasıl görüneceğini önizleyin (HTML döndürür):

bash

curl -X POST "https://api.astroapi.cloud/api/pdf-reports/preview" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "your-template-id"
  }'

Şablon Çözümlemesi

Bir PDF oluştururken sistem şu sırayla kullanılacak şablonu belirler:

Belirli şablon: İstekte templateId sağlandıysa
Kuruluş varsayılanı: Rapor türü için kuruluşun varsayılan şablonu
Genel varsayılan: Rapor türü için genel (paylaşılan) varsayılan şablon

Gerekli İzinler

Uç Nokta	İzin
Şablonları listele/al	`content:read`
PDF oluştur	`content:read`
Şablonu önizle	`content:read`
Şablon oluştur	`content:create`
Şablon güncelle	`content:update`
Şablon sil	`content:delete`
Şablonu çoğalt	`content:create`
Varsayılan ayarla	`content:update`

Rapor İçeriği

Oluşturulan raporlar şunları içerir:

Kişi bilgileri: Ad, doğum tarihi, saati ve konumu
Gezegen konumları: Burç, ev ve derece ile tüm büyük gezegenler
Ev köşeleri: İşaretlerle tüm 12 ev köşesi
Açılar: Orblar ve yorumlarla gezegen açıları
Yorumlar: Her konum ve açı için CMS kaynaklı metin içeriği

Gerçek içerik, şablon yapılandırmasına ve mevcut CMS içeriğine bağlıdır.

PDF Raporları ​

Genel Bakış ​

Desteklenen Rapor Türleri ​

PDF Raporu Oluşturma ​

İstek Parametreleri ​

Kişi Nesnesi ​

Yanıt ​

Sinastri Raporu Örneği ​

Güneş Dönüşü Raporu Örneği ​

Şablon Yönetimi ​

Şablonları Listele ​

Belirli Bir Şablon Al ​

Şablon Oluştur ​

Şablon Nitelikleri ​

Sayfa Ayarları ​

Üstbilgi/Altbilgi Yapılandırması ​

Şablon Güncelle ​

Şablon Sil ​

Şablonu Çoğalt ​

Varsayılan Şablon Ayarla ​

Şablon Önizleme ​

Şablon Çözümlemesi ​

Gerekli İzinler ​

Rapor İçeriği ​

PDF Raporları

Genel Bakış

Desteklenen Rapor Türleri

PDF Raporu Oluşturma

İstek Parametreleri

Kişi Nesnesi

Yanıt

Sinastri Raporu Örneği

Güneş Dönüşü Raporu Örneği

Şablon Yönetimi

Şablonları Listele

Belirli Bir Şablon Al

Şablon Oluştur

Şablon Nitelikleri

Sayfa Ayarları

Üstbilgi/Altbilgi Yapılandırması

Şablon Güncelle

Şablon Sil

Şablonu Çoğalt

Varsayılan Şablon Ayarla

Şablon Önizleme

Şablon Çözümlemesi

Gerekli İzinler

Rapor İçeriği