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

Membuat Tugas Lighthouse

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

DataForSEO

​

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

DataForSEO Operasi

Membuat Tugas Lighthouse

​

Mengantrekan audit Lighthouse alih-alih menunggu, mengembalikan id tugas. Gunakan saat audit akan melampaui kesabaran satu panggilan alat; ambil dengan get_dataforseo_on_page_lighthouse_task_get_json, dan lihat apa yang siap dengan get_dataforseo_on_page_lighthouse_ready. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Laporan 245 KB yang sama di akhir, jadi biaya konteks ditunda, bukan dihindari - persempit dengan categories atau audits di sini, bukan nanti.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.0051.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • audits
      Tipe: array string[] | null

      audit Lighthouse
      field opsional
      audit adalah pengujian individual yang dijalankan Lighthouse untuk setiap fitur/optimasi/metrik tertentu guna menghasilkan skor numerik (lihat definisi resmi)jika Anda mengabaikan field ini, kami akan mengembalikan data untuk semua audit
      gunakan field ini untuk mendapatkan data bagi audit tertentu yang Anda tentukan di sini

      catatan bahwa beberapa audit tidak termasuk dalam kategori tertentu dan merupakan pengukuran kualitas halaman yang berdiri sendiri

      secara umum, ada beberapa kasus penggunaan:

      1. jika Anda mengabaikan categories, Anda dapat menggunakan field ini untuk mendapatkan data hanya bagi audit yang ditentukan
      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 dapat menggunakan field ini untuk juga menerima audit yang tidak termasuk 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 "performance" dan semua audit di "seo"

      Anda dapat melihat daftar lengkap audit yang mungkin di sini

    • browser_cpu_throttling_multiplier
      Tipe: number | null

      pengali pembatasan CPU browser
      wajib jika browser_network_throttling_method disetel ke devtools;
      setel pengali pembatasan CPU untuk menyimulasikan kondisi performa perangkat selama audit Lighthouse;
      dapat ditentukan dalam rentang berikut: 1–4;
      Catatan: parameter ini hanya diterapkan jika browser_network_throttling_method disetel ke devtools;

    • browser_network_throttling
      Tipe: string | null

      pembatasan jaringan browser
      wajib jika browser_network_throttling_method disetel ke devtools;
      setel profil pembatasan jaringan untuk menyimulasikan kondisi kecepatan koneksi selama audit Lighthouse;
      nilai yang mungkin: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Catatan: parameter ini hanya diterapkan jika browser_network_throttling_method disetel ke devtools;

    • browser_network_throttling_method
      Tipe: string | null

      metode pembatasan jaringan browser
      field opsional
      menentukan metode yang digunakan untuk menerapkan pembatasan selama audit Lighthouse;
      nilai yang mungkin:
      simulate - menghitung perkiraan metrik performa tanpa menerapkan pembatasan eksplisit;
      devtools - menerapkan pengaturan pembatasan yang ditentukan di browser_network_throttling dan browser_cpu_throttling_multiplier;
      provided - menggunakan kondisi jaringan lingkungan perayapan;

    • browser_screen_height
      Tipe: integer | null

      tinggi layar browser
      field opsional
      setel tinggi layar browser yang digunakan untuk audit Lighthouse guna mengemulasi perangkat tertentu;
      dapat ditentukan dalam rentang berikut: 240–9999;

    • browser_screen_scale_factor
      Tipe: number | null

      faktor skala layar browser
      field opsional
      setel rasio piksel perangkat pada browser yang digunakan untuk audit Lighthouse;
      dapat ditentukan dalam rentang berikut: 0.5–3;

    • browser_screen_width
      Tipe: integer | null Format: int64

      lebar layar browser
      field opsional
      setel lebar layar browser yang digunakan untuk audit Lighthouse guna mengemulasi perangkat tertentu;
      dapat ditentukan dalam rentang berikut: 240–9999;

    • categories
      Tipe: array string[] | null

      kategori audit Lighthouse
      field opsional
      setiap kategori adalah kumpulan audit dan grup audit yang menerapkan pembobotan dan penilaian pada bagian tersebut (lihat definisi resmi)jika Anda mengabaikan field ini, kami akan mengembalikan data untuk semua kategori kecuali Anda menentukan audits
      gunakan field ini untuk mendapatkan data bagi kategori tertentu yang Anda tentukan di sini

      nilai yang mungkin:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Tipe: string | null

      user agent khusus
      field opsional
      tentukan user agent khusus yang digunakan browser saat menjalankan audit Lighthouse;
      dapat ditentukan hingga 254 karakter;

    • for_mobile
      Tipe: boolean | null

      menerapkan emulasi seluler
      field opsional
      jika disetel ke true, Lighthouse akan menggunakan emulasi perangkat dan layar seluler untuk menguji halaman di lingkungan seluler
      jika disetel ke false, hasil akan diberikan untuk desktop
      nilai default: false

    • language_code
      Tipe: string | null

      kode bahasa Lighthouse
      field opsional
      Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/on_page/lighthouse/languages
      nilai default:
      en

    • language_name
      Tipe: string | null

      nama bahasa Lighthouse
      field opsional
      Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/on_page/lighthouse/languages
      nilai default:
      English

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai
      field opsional
      saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam pingback_url akan dienkode URL;
      yaitu, karakter # akan dienkode menjadi %23 pelajari lebih lanjut di Pusat Bantuan kami

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • url
      Tipe: string

      URL target
      field wajib
      halaman target harus ditentukan dengan URL absolutnya (termasuk http:// atau https://)
      contoh:
      https://dataforseo.com/

    • version
      Tipe: string | null

      versi Lighthouse
      field opsional
      Anda dapat memperoleh hasil khusus untuk versi Lighthouse tertentu dengan menentukan nomornya
      daftar versi yang tersedia tersedia melalui endpoint Lighthouse Versions

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

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

      array tugas

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

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

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

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

          Jalur URL

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

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat 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 berhasil

Setting Lighthouse Tasks