Depanare

Lista scurtă de lucruri care chiar se strică, și cum le repari.

Blogul nu apare pe site-ul meu

  1. Verifică cheia și calea

    Containerul SDK are nevoie de data-key="pk_…" (cheia publică de pe pagina site-ului tău), iar data-base-path trebuie să corespundă căii de bază a blogului — /blog, dacă n-ai schimbat-o.

  2. Verifică starea de verificare

    Livrarea servește doar site-uri verificate. Un site neverificat returnează 404 pentru fiecare URL de livrare. Vezi verificarea site-ului.

  3. Verifică consola browserului

    Un fetch SDK eșuat loghează statusul HTTP. 404 înseamnă cheie/cale/verificare; orice altceva merită raportat.

Proxy-ul returnează 404 sau o pagină de eroare

  • Testează direct upstream-ul: curl https://api.dailysmith.com/v1/render/pk_YOUR_KEY/blog — dacă asta funcționează, problema e regula de rewrite; compar-o cu șabloanele (calea de bază trebuie transmisă mai departe exact așa cum e).
  • "no blog is mounted at this path" — calea pe care o transmite proxy-ul tău nu începe cu calea de bază a niciunui blog. Verifică dacă nu cumva ai un prefix eliminat sau dublat.
  • Specific pentru nginx: păstrează proxy_set_header Host api.dailysmith.com și proxy_ssl_server_name on, altfel TLS-ul către API va eșua.

Verificarea eșuează în continuare

Acoperit în detaliu la verificarea site-ului — de obicei e vorba de propagare DNS, un fișier well-known care redirecționează, sau un token copiat cu caractere în plus.

Un articol arată nestilizat pe site-ul meu

Componentele bogate își livrează foaia de stil odată cu conținutul. SDK-ul o încarcă o singură dată ca un <link id="baas-md2-css"> cacheable (plus un mic <style id="baas-theme-css"> inline pentru paleta ta de temă, dacă ai una); paginile SSR/complete inline-uiesc totul în loc. Dacă componentele se randează ca liste/paragrafe de text simplu:

  • SDK: confirmă că nimic de pe pagina ta nu elimină elementele <link>/<style> injectate în <head> după încărcare, și că Content-Security-Policy-ul tău permite originea API-ului în style-src (vezi blocul CSP, plus 'unsafe-inline' pentru temă) — o foaie de stil blocată eșuează silențios în consolă, nu vizibil pe pagină.
  • Dacă vezi culori greșite, nu lipsă, revizuiește-ți tema — sau elimin-o, ca să revii la paleta implicită.

Generarea e blocată sau a eșuat

  • În coadă/se generează de mai mult de ~10 minute nu e normal — pagina articolului se reîmprospătează automat; dacă nu se rezolvă niciodată, reîncearcă generarea.
  • Articolele Eșuate arată pasul care a eșuat și eroarea în istoricul de generare. Erorile trecătoare de model reușesc la reîncercare; o eroare de cotă înseamnă că sunt cheltuite creditele lunii (planuri și cote).

Programul meu nu a rulat

  • Verifică să nu fie pe pauză — programele se pun singure pe pauză când se epuizează cota și rămân pe pauză până le reiei.
  • Ora următoarei rulări de pe pagina blogului e cea corectă; orele sunt calculate în fusul orar al programului.
enro