การตั้งงาน Lighthouse

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

DataForSEO

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

DataForSEO การดำเนินการ

post/v1/beta/dataforseo/on_page/lighthouse/task_post

การตั้งงาน Lighthouse

เข้าคิว audit Lighthouse แทนการรอผล และคืน id ของงาน ใช้เมื่อ audit ใช้เวลานานเกินกว่าที่การเรียกเครื่องมือหนึ่งครั้งจะรอได้ ดึงผลด้วย get_dataforseo_on_page_lighthouse_task_get_json และดูว่าอะไรพร้อมแล้วด้วย get_dataforseo_on_page_lighthouse_ready ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 ⚠️ สุดท้ายก็ได้รายงาน 245 KB เท่าเดิม ต้นทุน context จึงถูกเลื่อนออกไป ไม่ได้หลีกเลี่ยง — ลดขนาดด้วย categories หรือ audits ตรงนี้ ไม่ใช่ทีหลัง

ข้อมูลอ้างอิงราคา

การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
ค่าประมาณคำขออ้างอิง: USD 0.0051
ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- audits
  ประเภท: array string[] | null
  
  audit ของ Lighthouse
  ฟิลด์ไม่บังคับ
  audit คือการทดสอบแต่ละรายการที่ Lighthouse รันสำหรับคุณสมบัติ/การปรับแต่ง/เมตริกเฉพาะ เพื่อสร้างคะแนนเป็นตัวเลข (ดูคำจำกัดความอย่างเป็นทางการ)หากเพิกเฉยต่อฟิลด์นี้ เราจะส่งคืนข้อมูลสำหรับ audit ทั้งหมด
  ใช้ฟิลด์นี้เพื่อรับข้อมูลสำหรับ audit เฉพาะที่คุณระบุที่นี่
  
  หมายเหตุว่า audit บางรายการไม่ได้อยู่ในหมวดหมู่เฉพาะและเป็นการวัดคุณภาพหน้าเว็บแบบเดี่ยว
  
  โดยทั่วไปแล้ว อาจมีกรณีการใช้งานหลายแบบ:
  
  1. หากเพิกเฉยต่อ categories คุณสามารถใช้ฟิลด์นี้เพื่อรับข้อมูลเฉพาะ audit ที่ระบุ
  ตัวอย่างเช่น หากเพิกเฉยต่อ "categories" และระบุ "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] คุณจะได้รับข้อมูลเฉพาะ audit เหล่านี้
  
  2. หากระบุหมวดหมู่ คุณสามารถใช้ฟิลด์นี้เพื่อรับ audit เพิ่มเติมที่ไม่ได้อยู่ในหมวดหมู่ที่คุณระบุ
  ตัวอย่างเช่น หากระบุ "categories": ["seo"] และ "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"] คุณจะได้รับเฉพาะ audit เหล่านี้ภายใต้ "performance" และ audit ทั้งหมดภายใต้ "seo"
  
  คุณสามารถรับ รายการ audit ที่เป็นไปได้ทั้งหมดได้ที่นี่
- browser_cpu_throttling_multiplier
  ประเภท: number | null
  
  ตัวคูณการจำกัด CPU ของเบราว์เซอร์
  จำเป็นหาก browser_network_throttling_method ตั้งเป็น devtools;
  ตั้งตัวคูณการจำกัด CPU เพื่อจำลองสภาวะประสิทธิภาพของอุปกรณ์ระหว่าง audit ของ Lighthouse;
  ระบุได้ภายในช่วงต่อไปนี้: 1–4;
  หมายเหตุ: พารามิเตอร์นี้ใช้เฉพาะเมื่อ browser_network_throttling_method ตั้งเป็น devtools;
- browser_network_throttling
  ประเภท: string | null
  
  การจำกัดเครือข่ายของเบราว์เซอร์
  จำเป็นหาก browser_network_throttling_method ตั้งเป็น devtools;
  ตั้งโปรไฟล์การจำกัดเครือข่ายเพื่อจำลองสภาวะความเร็วการเชื่อมต่อระหว่าง audit ของ Lighthouse;
  ค่าที่เป็นไปได้: no_throttling, fast_4g, slow_4g, regular_3g, pc;
  หมายเหตุ: พารามิเตอร์นี้ใช้เฉพาะเมื่อ browser_network_throttling_method ตั้งเป็น devtools;
- browser_network_throttling_method
  ประเภท: string | null
  
  วิธีการจำกัดเครือข่ายของเบราว์เซอร์
  ฟิลด์ไม่บังคับ
  กำหนดวิธีการที่ใช้ในการจำกัดระหว่าง audit ของ Lighthouse;
  ค่าที่เป็นไปได้:
  simulate - คำนวณเมตริกประสิทธิภาพโดยประมาณโดยไม่ใช้การจำกัดอย่างชัดเจน;
  devtools - ใช้การตั้งค่าการจำกัดที่ระบุใน browser_network_throttling และ browser_cpu_throttling_multiplier;
  provided - ใช้สภาวะเครือข่ายของสภาพแวดล้อมที่ crawl;
- browser_screen_height
  ประเภท: integer | null
  
  ความสูงหน้าจอเบราว์เซอร์
  ฟิลด์ไม่บังคับ
  ตั้งความสูงหน้าจอของเบราว์เซอร์ที่ใช้สำหรับ audit ของ Lighthouse เพื่อจำลองอุปกรณ์เฉพาะ;
  ระบุได้ภายในช่วงต่อไปนี้: 240–9999;
- browser_screen_scale_factor
  ประเภท: number | null
  
  ตัวคูณสเกลหน้าจอเบราว์เซอร์
  ฟิลด์ไม่บังคับ
  ตั้งอัตราส่วนพิกเซลของอุปกรณ์ของเบราว์เซอร์ที่ใช้สำหรับ audit ของ Lighthouse;
  ระบุได้ภายในช่วงต่อไปนี้: 0.5–3;
- browser_screen_width
  ประเภท: integer | null รูปแบบ: int64
  
  ความกว้างหน้าจอเบราว์เซอร์
  ฟิลด์ไม่บังคับ
  ตั้งความกว้างหน้าจอของเบราว์เซอร์ที่ใช้สำหรับ audit ของ Lighthouse เพื่อจำลองอุปกรณ์เฉพาะ;
  ระบุได้ภายในช่วงต่อไปนี้: 240–9999;
- categories
  ประเภท: array string[] | null
  
  หมวดหมู่ของ audit ใน Lighthouse
  ฟิลด์ไม่บังคับ
  แต่ละหมวดหมู่คือชุดของ audit และกลุ่ม audit ที่ใช้การถ่วงน้ำหนักและการให้คะแนนกับส่วนนั้น (ดูคำจำกัดความอย่างเป็นทางการ)หากเพิกเฉยต่อฟิลด์นี้ เราจะส่งคืนข้อมูลสำหรับทุกหมวดหมู่ เว้นแต่คุณจะระบุ audits
  ใช้ฟิลด์นี้เพื่อรับข้อมูลสำหรับหมวดหมู่เฉพาะที่คุณระบุที่นี่
  
  ค่าที่เป็นไปได้:
  seo, performance, best_practices, accessibility
- custom_user_agent
  ประเภท: string | null
  
  user agent แบบกำหนดเอง
  ฟิลด์ไม่บังคับ
  ระบุ user agent แบบกำหนดเองที่เบราว์เซอร์ใช้เมื่อรัน audit ของ Lighthouse;
  ระบุได้สูงสุด 254 อักขระ;
- for_mobile
  ประเภท: boolean | null
  
  ใช้การจำลองมือถือ
  ฟิลด์ไม่บังคับ
  หากตั้งเป็น true Lighthouse จะใช้อุปกรณ์มือถือและการจำลองหน้าจอเพื่อทดสอบหน้าเว็บกับสภาพแวดล้อมมือถือ
  หากตั้งเป็น false ผลลัพธ์จะถูกจัดหาให้สำหรับเดสก์ท็อป
  ค่าเริ่มต้น: false
- language_code
  ประเภท: string | null
  
  รหัสภาษาของ lighthouse
  ฟิลด์ไม่บังคับ
  คุณสามารถรับรายการภาษาที่เครื่องมือค้นหามีให้พร้อม language_code ได้โดยส่งคำขอแยกไปยัง https://api.dataforseo.com/v3/on_page/lighthouse/languages
  ค่าเริ่มต้น:
  en
- language_name
  ประเภท: string | null
  
  ชื่อภาษาของ lighthouse
  ฟิลด์ไม่บังคับ
  คุณสามารถรับรายการภาษาที่เครื่องมือค้นหามีให้พร้อม language_name ได้โดยส่งคำขอแยกไปยัง https://api.dataforseo.com/v3/on_page/lighthouse/languages
  ค่าเริ่มต้น:
  English
- pingback_url
  ประเภท: string | null
  
  URL แจ้งเตือนของงานที่เสร็จสิ้น
  ฟิลด์ไม่บังคับ
  เมื่องานเสร็จสิ้น เราจะแจ้งให้คุณทราบด้วยคำขอ GET ที่ส่งไปยัง URL ที่คุณระบุ
  คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร $id และ ‘$tag’ เป็นตัวแปร $tag ที่เข้ารหัส URL เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ
  ตัวอย่าง:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  หมายเหตุ: อักขระพิเศษใน pingback_url จะถูกเข้ารหัส URL;
  เช่น อักขระ # จะถูกเข้ารหัสเป็น %23ดูข้อมูลเพิ่มเติมได้ที่ Help Center ของเรา
- tag
  ประเภท: string | null
  
  ตัวระบุงานที่ผู้ใช้กำหนด
  ฟิลด์ไม่บังคับ
  จำกัด 255 อักขระ
  ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
  คุณจะพบค่า tag ที่ระบุในออบเจ็กต์ data ของการตอบกลับ
- url
  ประเภท: string
  
  URL เป้าหมาย
  ฟิลด์ที่จำเป็น
  หน้าเป้าหมายควรระบุด้วย URL แบบสัมบูรณ์ (รวม http:// หรือ https://)
  ตัวอย่าง:
  https://dataforseo.com/
- version
  ประเภท: string | null
  
  เวอร์ชัน lighthouse
  ฟิลด์ไม่บังคับ
  คุณสามารถรับผลลัพธ์เฉพาะเจาะจงสำหรับเวอร์ชัน Lighthouse ที่กำหนดได้โดยระบุหมายเลขเวอร์ชัน
  รายการเวอร์ชันที่ใช้ได้มีให้ผ่าน endpoint Lighthouse Versions

การตอบกลับ

200
ประเภท: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

status_code
ประเภท: integer | null

รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

tasks
ประเภท: array (object | null)[] | null

อาร์เรย์ของงาน

ประเภท: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostTaskInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

data
ประเภท: object | null

มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

propertyName
ประเภท: object | null
id
ประเภท: string | null

ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID

path
ประเภท: array (string | null)[] | null

พาธ URL

result
ประเภท: array (object | null)[] | null
propertyName
ประเภท: object | null
result_count
ประเภท: integer | null รูปแบบ: int64

จำนวนองค์ประกอบในอาร์เรย์ result

status_code
ประเภท: integer | null

รหัสสถานะของงาน สร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000 คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลของงาน คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

time
ประเภท: string | null

เวลาดำเนินการ, วินาที

tasks_count
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks

tasks_error
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

time
ประเภท: string | null

เวลาดำเนินการทั้งหมด (วินาที)

version
ประเภท: string | null

เวอร์ชันปัจจุบันของ API
application/json
400

ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
401

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
402

ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
403

บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
429

ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
502

บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
503

API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
504

บริการหมดเวลาระหว่างประมวลผลคำขอ
default

การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

application/json

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

ดำเนินการสำเร็จ

การตั้งงาน Lighthouse

การยืนยันตัวตนRequired

DataForSEO

การตั้งงาน Lighthouse

ข้อมูลอ้างอิงราคา