Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Lighthouse Görevlerini Ayarlama

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

Lighthouse Görevlerini Ayarlama

​

Bir Lighthouse denetimini beklemek yerine kuyruğa alır ve bir görev id değeri döndürür. Denetim bir araç çağrısının sabrını aşacaksa kullanın; get_dataforseo_on_page_lighthouse_task_get_json ile getirin ve nelerin hazır olduğunu get_dataforseo_on_page_lighthouse_ready ile görün. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. ⚠️ Sonunda yine aynı 245 KB'lik rapor var; yani bağlam maliyeti ertelenir, önlenmez — burada categories veya audits ile daraltın, sonra değil.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.0051.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
application/json
  • Tür: array (object | null)[]
    • audits
      Tür: array string[] | null

      Lighthouse denetimleri
      isteğe bağlı alan
      denetimler, Lighthouse'un sayısal bir puan üretmek için her belirli özellik/optimizasyon/metrik için çalıştırdığı bireysel testlerdir (resmi tanıma bakın)bu alanı yok sayarsanız tüm denetimler için veri döndürürüz
      bu alanı, burada belirttiğiniz belirli denetimler için veri almak üzere kullanın

      not bazı denetimler belirli bir kategoriye ait değildir ve bağımsız sayfa kalitesi ölçümleridir

      genel olarak birkaç kullanım durumu olabilir:

      1. categories alanını yok sayarsanız bu alanı yalnızca belirtilen denetimler için veri almak üzere kullanabilirsiniz
      örneğin "categories" alanını yok sayıp "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] belirtirseniz yalnızca bu denetimler için veri alırsınız

      2. bir kategori belirtirseniz bu alanı, belirttiğiniz kategorilere ait olmayan denetimleri ek olarak almak için kullanabilirsiniz
      örneğin "categories": ["seo"] ve "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] belirtirseniz "performance" altında yalnızca bu denetimleri ve "seo" altındaki tüm denetimleri alırsınız

      Olası denetimlerin tam listesine buradan ulaşabilirsiniz

    • browser_cpu_throttling_multiplier
      Tür: number | null

      tarayıcı CPU kısıtlama çarpanı
      browser_network_throttling_method devtools olarak ayarlanmışsa zorunludur;
      Lighthouse denetimi sırasında cihaz performans koşullarını simüle etmek için CPU kısıtlama çarpanını ayarlayın;
      şu aralıkta belirtilebilir: 1–4;
      Not: bu parametre yalnızca browser_network_throttling_method devtools olarak ayarlandığında uygulanır;

    • browser_network_throttling
      Tür: string | null

      tarayıcı ağ kısıtlaması
      browser_network_throttling_method devtools olarak ayarlanmışsa zorunludur;
      Lighthouse denetimi sırasında bağlantı hızı koşullarını simüle etmek için ağ kısıtlama profilini ayarlayın;
      olası değerler: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Not: bu parametre yalnızca browser_network_throttling_method devtools olarak ayarlandığında uygulanır;

    • browser_network_throttling_method
      Tür: string | null

      tarayıcı ağ kısıtlama yöntemi
      isteğe bağlı alan
      Lighthouse denetimi sırasında kısıtlama uygulamak için kullanılan yöntemi tanımlar;
      olası değerler:
      simulate - açık kısıtlama uygulamadan tahmini performans metriklerini hesaplar;
      devtools - browser_network_throttling ve browser_cpu_throttling_multiplier içinde belirtilen kısıtlama ayarlarını uygular;
      provided - tarama ortamının ağ koşullarını kullanır;

    • browser_screen_height
      Tür: integer | null

      tarayıcı ekran yüksekliği
      isteğe bağlı alan
      belirli bir cihazı öykünmek için Lighthouse denetiminde kullanılan tarayıcının ekran yüksekliğini ayarlayın;
      şu aralıkta belirtilebilir: 240–9999;

    • browser_screen_scale_factor
      Tür: number | null

      tarayıcı ekran ölçek faktörü
      isteğe bağlı alan
      Lighthouse denetiminde kullanılan tarayıcının cihaz piksel oranını ayarlayın;
      şu aralıkta belirtilebilir: 0.5–3;

    • browser_screen_width
      Tür: integer | null Biçim: int64

      tarayıcı ekran genişliği
      isteğe bağlı alan
      belirli bir cihazı öykünmek için Lighthouse denetiminde kullanılan tarayıcının ekran genişliğini ayarlayın;
      şu aralıkta belirtilebilir: 240–9999;

    • categories
      Tür: array string[] | null

      Lighthouse denetim kategorileri
      isteğe bağlı alan
      her kategori, bölüme ağırlıklandırma ve puanlama uygulayan bir denetimler ve denetim grupları koleksiyonudur (resmi tanıma bakın)bu alanı yok sayarsanız audits belirtmediğiniz sürece tüm kategoriler için veri döndürürüz
      bu alanı, burada belirttiğiniz belirli kategoriler için veri almak üzere kullanın

      olası değerler:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Tür: string | null

      özel user agent
      isteğe bağlı alan
      Lighthouse denetimi çalıştırılırken tarayıcının kullanacağı özel user agent değerini belirtin;
      254 karaktere kadar belirtilebilir;

    • for_mobile
      Tür: boolean | null

      mobil öykünme uygular
      isteğe bağlı alan
      true olarak ayarlanırsa Lighthouse, sayfayı mobil ortamda test etmek için mobil cihaz ve ekran öykünmesi kullanır
      false olarak ayarlanırsa sonuçlar masaüstü için sağlanır
      varsayılan değer: false

    • language_code
      Tür: string | null

      Lighthouse dil kodu
      isteğe bağlı alan
      arama motorunun kullanılabilir dillerinin listesini language_code değerleriyle birlikte https://api.dataforseo.com/v3/on_page/lighthouse/languages adresine ayrı bir istek göndererek alabilirsiniz
      varsayılan değer:
      en

    • language_name
      Tür: string | null

      Lighthouse dil adı
      isteğe bağlı alan
      arama motorunun kullanılabilir dillerinin listesini language_name değerleriyle birlikte https://api.dataforseo.com/v3/on_page/lighthouse/languages adresine ayrı bir istek göndererek alabilirsiniz
      varsayılan değer:
      English

    • pingback_url
      Tür: string | null

      tamamlanan görevin bildirim URL'si
      isteğe bağlı alan
      görev tamamlandığında, belirttiğiniz URL'ye gönderilen bir GET isteğiyle sizi bilgilendireceğiz
      ‘$id’ dizesini $id değişkeni olarak, ‘$tag’ dizesini URL kodlamalı $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
      örnek:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Not: pingback_url içindeki özel karakterler URL kodlamasına tabi tutulur;
      örneğin # karakteri %23 olarak kodlanır daha fazla bilgi için Yardım Merkezimize bakın

    • tag
      Tür: string | null

      kullanıcı tanımlı görev tanımlayıcısı
      isteğe bağlı alan
      karakter sınırı 255
      bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
      belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

    • url
      Tür: string

      hedef URL
      zorunlu alan
      hedef sayfa mutlak URL'siyle belirtilmelidir (http:// veya https:// dahil)
      örnek:
      https://dataforseo.com/

    • version
      Tür: string | null

      Lighthouse sürümü
      isteğe bağlı alan
      numarasını belirterek belirli bir Lighthouse sürümüne özgü sonuçları alabilirsiniz
      kullanılabilir sürümlerin listesine Lighthouse Versions uç noktasından ulaşabilirsiniz

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
    • cost
      Tür: number | null Biçim: double

      toplam görev maliyeti, USD

    • status_code
      Tür: integer | null

      genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

    • status_message
      Tür: string | null

      genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array (object | null)[] | null

      görev dizisi

      • Tür: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
        • cost
          Tür: number | null Biçim: double

          toplam görev maliyeti, USD

        • data
          Tür: object | null

          POST isteğinde belirttiğiniz parametrelerin aynısını içerir

          • propertyName
            Tür: object | null
        • id
          Tür: string | null

          görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

        • path
          Tür: array (string | null)[] | null

          URL yolu

        • result
          Tür: array (object | null)[] | null
          • propertyName
            Tür: object | null
        • result_count
          Tür: integer | null Biçim: int64

          result dizisindeki öğe sayısı

        • status_code
          Tür: integer | null

          görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

        • status_message
          Tür: string | null

          görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

        • time
          Tür: string | null

          yürütme süresi, saniye

    • tasks_count
      Tür: integer | null Biçim: int64

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer | null Biçim: int64

      tasks dizisinde hata ile dönen görev sayısı

    • time
      Tür: string | null

      toplam yürütme süresi, saniye

    • version
      Tür: string | null

      API'nin geçerli sürümü

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

    application/json
Request Example for post/v1/beta/dataforseo/on_page/lighthouse/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/lighthouse/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com",
    "for_mobile": true,
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        null
      ]
    }
  ]
}

Başarılı işlem

Setting Lighthouse Tasks