Depanare
Lista scurtă de lucruri care chiar se strică, și cum le repari.
Blogul nu apare pe site-ul meu
Verifică cheia și calea Containerul SDK are nevoie de
data-key="pk_…"(cheia publică de pe pagina site-ului tău), iardata-base-pathtrebuie să corespundă căii de bază a blogului —/blog, dacă n-ai schimbat-o.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.
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șiproxy_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 înstyle-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.