Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Mencipta Tugas Lighthouse

Felo API Support
MIT
Pelayan:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Mencipta Tugas Lighthouse

​

Menghantar audit Lighthouse ke baris gilir tanpa menunggu, memulangkan id tugas. Gunakan apabila audit akan melebihi kesabaran satu panggilan alat; ambil dengan get_dataforseo_on_page_lighthouse_task_get_json, dan lihat apa yang sedia dengan get_dataforseo_on_page_lighthouse_ready. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Laporan 245 KB yang sama pada akhirnya, jadi kos konteks ditangguhkan, bukan dielakkan - kecilkan dengan categories atau audits di sini, bukan kemudian.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.0051.
  • Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan
application/json
  • Jenis: array (object | null)[]
    • audits
      Jenis: array string[] | null

      audit Lighthouse
      medan pilihan
      audit ialah ujian individu yang dijalankan Lighthouse bagi setiap ciri/pengoptimuman/metrik tertentu untuk menghasilkan skor numerik (lihat definisi rasmi)jika anda mengabaikan medan ini, kami akan memulangkan data untuk semua audit
      gunakan medan ini untuk mendapatkan data bagi audit tertentu yang anda tentukan di sini

      nota bahawa sesetengah audit tidak tergolong dalam kategori tertentu dan merupakan ukuran kualiti halaman tersendiri

      secara umum, terdapat beberapa kes penggunaan:

      1. jika anda mengabaikan categories, anda boleh menggunakan medan ini untuk mendapatkan data bagi audit yang ditentukan sahaja
      contoh: jika anda mengabaikan "categories" dan menentukan "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], anda hanya akan mendapatkan data untuk audit tersebut

      2. jika anda menentukan kategori, anda boleh menggunakan medan ini untuk turut menerima audit yang tidak tergolong dalam kategori yang anda tentukan
      contoh: jika anda menentukan "categories": ["seo"] dan "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], anda hanya akan mendapatkan audit tersebut di bawah "performance" dan semua audit di bawah "seo"

      anda boleh mendapatkan senarai penuh audit yang mungkin di sini

    • browser_cpu_throttling_multiplier
      Jenis: number | null

      pengganda pengehadan CPU pelayar
      wajib jika browser_network_throttling_method ditetapkan kepada devtools;
      tetapkan pengganda pengehadan CPU untuk mensimulasikan keadaan prestasi peranti semasa audit Lighthouse;
      boleh ditentukan dalam julat berikut: 1–4;
      Nota: parameter ini digunakan hanya apabila browser_network_throttling_method ditetapkan kepada devtools;

    • browser_network_throttling
      Jenis: string | null

      pengehadan rangkaian pelayar
      wajib jika browser_network_throttling_method ditetapkan kepada devtools;
      tetapkan profil pengehadan rangkaian untuk mensimulasikan keadaan kelajuan sambungan semasa audit Lighthouse;
      nilai yang tersedia: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Nota: parameter ini digunakan hanya apabila browser_network_throttling_method ditetapkan kepada devtools;

    • browser_network_throttling_method
      Jenis: string | null

      kaedah pengehadan rangkaian pelayar
      medan pilihan
      menentukan kaedah yang digunakan untuk menggunakan pengehadan semasa audit Lighthouse;
      nilai yang tersedia:
      simulate - mengira metrik prestasi anggaran tanpa menggunakan pengehadan eksplisit;
      devtools - menggunakan tetapan pengehadan yang ditentukan dalam browser_network_throttling dan browser_cpu_throttling_multiplier;
      provided - menggunakan keadaan rangkaian persekitaran perangkak;

    • browser_screen_height
      Jenis: integer | null

      tinggi skrin pelayar
      medan pilihan
      tetapkan tinggi skrin pelayar yang digunakan untuk audit Lighthouse bagi mengemulasi peranti tertentu;
      boleh ditentukan dalam julat berikut: 240–9999;

    • browser_screen_scale_factor
      Jenis: number | null

      faktor skala skrin pelayar
      medan pilihan
      tetapkan nisbah piksel peranti pelayar yang digunakan untuk audit Lighthouse;
      boleh ditentukan dalam julat berikut: 0.5–3;

    • browser_screen_width
      Jenis: integer | null Format: int64

      lebar skrin pelayar
      medan pilihan
      tetapkan lebar skrin pelayar yang digunakan untuk audit Lighthouse bagi mengemulasi peranti tertentu;
      boleh ditentukan dalam julat berikut: 240–9999;

    • categories
      Jenis: array string[] | null

      kategori audit Lighthouse
      medan pilihan
      setiap kategori ialah koleksi audit dan kumpulan audit yang menggunakan pemberat dan pemarkahan pada bahagian tersebut (lihat definisi rasmi)jika anda mengabaikan medan ini, kami akan memulangkan data untuk semua kategori melainkan anda menentukan audits
      gunakan medan ini untuk mendapatkan data bagi kategori tertentu yang anda tentukan di sini

      nilai yang tersedia:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Jenis: string | null

      user agent tersuai
      medan pilihan
      tentukan user agent tersuai yang digunakan oleh pelayar semasa menjalankan audit Lighthouse;
      boleh ditentukan sehingga 254 aksara;

    • for_mobile
      Jenis: boolean | null

      menggunakan emulasi mudah alih
      medan pilihan
      jika ditetapkan kepada true, Lighthouse akan menggunakan emulasi peranti dan skrin mudah alih untuk menguji halaman dalam persekitaran mudah alih
      jika ditetapkan kepada false, hasil akan diberikan untuk desktop
      nilai lalai: false

    • language_code
      Jenis: string | null

      kod bahasa Lighthouse
      medan pilihan
      anda boleh menerima senarai bahasa enjin carian yang tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/on_page/lighthouse/languages
      nilai lalai:
      en

    • language_name
      Jenis: string | null

      nama bahasa Lighthouse
      medan pilihan
      anda boleh menerima senarai bahasa enjin carian yang tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/on_page/lighthouse/languages
      nilai lalai:
      English

    • pingback_url
      Jenis: string | null

      URL pemberitahuan tugas yang selesai
      medan pilihan
      apabila tugas selesai, kami akan memberitahu anda melalui permintaan GET yang dihantar ke URL yang anda tentukan
      anda boleh menggunakan string ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag berkod URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Nota: aksara khas dalam pingback_url akan dikodkan URL;
      iaitu, aksara # akan dikodkan menjadi %23 ketahui lebih lanjut di Pusat Bantuan kami

    • tag
      Jenis: string | null

      pengecam tugas yang ditentukan pengguna
      medan pilihan
      had aksara ialah 255
      anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
      anda akan menemui nilai tag yang ditentukan dalam objek data respons

    • url
      Jenis: string

      URL sasaran
      medan wajib
      halaman sasaran mesti ditentukan dengan URL mutlaknya (termasuk http:// atau https://)
      contoh:
      https://dataforseo.com/

    • version
      Jenis: string | null

      versi Lighthouse
      medan pilihan
      anda boleh mendapatkan hasil khusus bagi versi Lighthouse tertentu dengan menentukan nombornya
      senarai versi yang tersedia boleh didapati melalui endpoint Lighthouse Versions

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

    • tasks
      Jenis: array (object | null)[] | null

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

          • propertyName
            Jenis: object | null
        • id
          Jenis: string | null

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

        • path
          Jenis: array (string | null)[] | null

          Laluan URL

        • result
          Jenis: array (object | null)[] | null
          • propertyName
            Jenis: object | null
        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      versi semasa API

    application/json
  • 400

    Permintaan tidak dapat diproses. Semak parameter permintaan.

  • 401

    Kunci API Felo yang sah diperlukan.

  • 402

    Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

  • 403

    Akaun tidak dibenarkan melakukan operasi ini.

  • 429

    Had permintaan atau had perbelanjaan telah dicapai.

  • 502

    Perkhidmatan tidak dapat menyelesaikan permintaan.

  • 503

    API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

  • 504

    Perkhidmatan tamat masa semasa memproses permintaan.

  • default

    Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

    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
      ]
    }
  ]
}

Operasi berjaya

Setting Lighthouse Tasks