Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tworzenie zadań Lighthouse

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

DataForSEO

​

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

DataForSEO Operacje

Tworzenie zadań Lighthouse

​

Kolejkuje audyt Lighthouse zamiast czekać na niego i zwraca id zadania. Użyj go, gdy audyt przekroczyłby cierpliwość wywołania narzędzia; pobierz przez get_dataforseo_on_page_lighthouse_task_get_json, a gotowe zadania sprawdzisz przez get_dataforseo_on_page_lighthouse_ready. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. ⚠️ Na końcu ten sam raport 245 KB, więc koszt kontekstu jest odroczony, a nie uniknięty — zawęź go tutaj przez categories lub audits, nie później.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.0051.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
application/json
  • Typ: array (object | null)[]
    • audits
      Typ: array string[] | null

      audyty Lighthouse
      pole opcjonalne
      audyty to pojedyncze testy, które Lighthouse przeprowadza dla każdej funkcji/optymalizacji/metryki, aby uzyskać wynik liczbowy (zobacz oficjalną definicję)jeśli pominiesz to pole, zwrócimy dane dla wszystkich audytów
      użyj tego pola, aby uzyskać dane dla konkretnych audytów wskazanych tutaj

      uwaga niektóre audyty nie należą do konkretnej kategorii i są samodzielnymi pomiarami jakości strony

      ogólnie można wyróżnić kilka przypadków użycia:

      1. jeśli pominiesz categories, możesz użyć tego pola, aby uzyskać dane tylko dla podanych audytów
      na przykład jeśli pominiesz "categories" i podasz "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], otrzymasz dane tylko dla tych audytów

      2. jeśli podasz kategorię, możesz użyć tego pola, aby dodatkowo otrzymać audyty nienależące do wskazanych kategorii
      na przykład jeśli podasz "categories": ["seo"] i "audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], otrzymasz tylko te audyty w kategorii "performance" oraz wszystkie audyty w kategorii "seo"

      pełną listę możliwych audytów znajdziesz tutaj

    • browser_cpu_throttling_multiplier
      Typ: number | null

      mnożnik dławienia CPU przeglądarki
      wymagane, jeśli browser_network_throttling_method ma wartość devtools;
      ustaw mnożnik dławienia CPU, aby symulować warunki wydajności urządzenia podczas audytu Lighthouse;
      można podać w zakresie: 1–4;
      Uwaga: ten parametr jest stosowany tylko wtedy, gdy browser_network_throttling_method ma wartość devtools;

    • browser_network_throttling
      Typ: string | null

      dławienie sieci przeglądarki
      wymagane, jeśli browser_network_throttling_method ma wartość devtools;
      ustaw profil dławienia sieci, aby symulować warunki prędkości połączenia podczas audytu Lighthouse;
      możliwe wartości: no_throttling, fast_4g, slow_4g, regular_3g, pc;
      Uwaga: ten parametr jest stosowany tylko wtedy, gdy browser_network_throttling_method ma wartość devtools;

    • browser_network_throttling_method
      Typ: string | null

      metoda dławienia sieci przeglądarki
      pole opcjonalne
      określa metodę stosowaną do dławienia podczas audytu Lighthouse;
      możliwe wartości:
      simulate - oblicza szacowane metryki wydajności bez stosowania jawnego dławienia;
      devtools - stosuje ustawienia dławienia podane w browser_network_throttling i browser_cpu_throttling_multiplier;
      provided - używa warunków sieciowych środowiska przeszukiwania;

    • browser_screen_height
      Typ: integer | null

      wysokość ekranu przeglądarki
      pole opcjonalne
      ustaw wysokość ekranu przeglądarki używanej do audytu Lighthouse, aby emulować konkretne urządzenie;
      można podać w zakresie: 240–9999;

    • browser_screen_scale_factor
      Typ: number | null

      współczynnik skali ekranu przeglądarki
      pole opcjonalne
      ustaw stosunek pikseli urządzenia dla przeglądarki używanej do audytu Lighthouse;
      można podać w zakresie: 0.5–3;

    • browser_screen_width
      Typ: integer | null Format: int64

      szerokość ekranu przeglądarki
      pole opcjonalne
      ustaw szerokość ekranu przeglądarki używanej do audytu Lighthouse, aby emulować konkretne urządzenie;
      można podać w zakresie: 240–9999;

    • categories
      Typ: array string[] | null

      kategorie audytów Lighthouse
      pole opcjonalne
      każda kategoria to zbiór audytów i grup audytów, do którego stosuje się ważenie i punktację sekcji (zobacz oficjalną definicję)jeśli pominiesz to pole, zwrócimy dane dla wszystkich kategorii, chyba że podasz audits
      użyj tego pola, aby uzyskać dane dla konkretnych kategorii wskazanych tutaj

      możliwe wartości:
      seo, performance, best_practices, accessibility

    • custom_user_agent
      Typ: string | null

      niestandardowy user agent
      pole opcjonalne
      podaj niestandardowy user agent używany przez przeglądarkę podczas audytu Lighthouse;
      można podać do 254 znaków;

    • for_mobile
      Typ: boolean | null

      stosuje emulację mobilną
      pole opcjonalne
      jeśli ustawione na true, Lighthouse użyje emulacji urządzenia mobilnego i ekranu do testowania strony w środowisku mobilnym
      jeśli ustawione na false, wyniki zostaną podane dla komputera
      wartość domyślna: false

    • language_code
      Typ: string | null

      kod języka Lighthouse
      pole opcjonalne
      listę dostępnych języków wyszukiwarki wraz z ich language_code możesz otrzymać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/on_page/lighthouse/languages
      wartość domyślna:
      en

    • language_name
      Typ: string | null

      nazwa języka Lighthouse
      pole opcjonalne
      listę dostępnych języków wyszukiwarki wraz z ich language_name możesz otrzymać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/on_page/lighthouse/languages
      wartość domyślna:
      English

    • pingback_url
      Typ: string | null

      URL powiadomienia o ukończonym zadaniu
      pole opcjonalne
      po ukończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany URL
      możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag kodowanej w URL. Przed wysłaniem żądania ustawimy niezbędne wartości.
      przykład:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Uwaga: znaki specjalne w pingback_url zostaną zakodowane w URL;
      m.in. znak # zostanie zakodowany jako %23więcej informacji w naszym Centrum pomocy

    • tag
      Typ: string | null

      identyfikator zadania zdefiniowany przez użytkownika
      pole opcjonalne
      limit znaków: 255
      ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
      podaną wartość tag znajdziesz w obiekcie data odpowiedzi

    • url
      Typ: string

      docelowy URL
      pole wymagane
      docelową stronę należy podać jako bezwzględny URL (z http:// lub https://)
      przykład:
      https://dataforseo.com/

    • version
      Typ: string | null

      wersja Lighthouse
      pole opcjonalne
      możesz otrzymać wyniki dla konkretnej wersji Lighthouse, podając jej numer
      lista dostępnych wersji jest dostępna w endpoincie Lighthouse Versions

Odpowiedzi
  • 200
    Typ: object | null · Response36Afe1097B20_OnPageLighthouseTaskPostResponseInfo
    • cost
      Typ: number | null Format: double

      łączny koszt zadań, USD

    • status_code
      Typ: integer | null

      ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

    • status_message
      Typ: string | null

      ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

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

      tablica zadań

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

          łączny koszt zadań, USD

        • data
          Typ: object | null

          zawiera te same parametry, które podano w żądaniu POST

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

          identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

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

          ścieżka URL

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

          liczba elementów w tablicy result

        • status_code
          Typ: integer | null

          kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

        • status_message
          Typ: string | null

          komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

        • time
          Typ: string | null

          czas wykonania, sekundy

    • tasks_count
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks

    • tasks_error
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks zwróconych z błędem

    • time
      Typ: string | null

      łączny czas wykonania, sekundy

    • version
      Typ: string | null

      bieżąca wersja interfejsu API

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Operacja zakończona powodzeniem

Setting Lighthouse Tasks