# Felsök API-, CLI- och MCP-anslutningar

Kanonisk URL: https://sosoapi.ai/sv/docs/troubleshooting

Lös fel med inloggning, behörigheter, scheman, uppladdning och osäkra skrivningar utan att exponera autentiseringsuppgifter eller duplicera accepterat arbete.

## Fel webbläsare eller blockerad lokal inloggning

Stoppa väntande inloggning och kör sedan auth login --no-open. Öppna den nya utskrivna URL:en i önskad webbläsarprofil. Kontrollera konto och arbetsyta innan du beviljar åtkomst och använd bara en webbläsarprofil för inloggningslänken. Om port 8789 är upptagen identifierar du lyssnaren och stoppar den endast om det är en inloggningsprocess som du startat.

```
npx sosoapi auth login --no-open
```

```
lsof -nP -iTCP:8789 -sTCP:LISTEN
```

## 401, 403 och otillgängliga konton

Vid 401 kontrollerar du att du är inloggad med giltiga uppgifter. Vid 403 kontrollerar du arbetsyteroll, valt omfång och den funktion som åtgärden kräver. Använd auth status och verifiera kontots e-post och godtagen uppgiftstyp. Ändra åtkomst endast om åtgärden kräver det; att byta verktygsprofil ger ingen behörighet.

Kontrollera det sociala kontot separat. Läs anslutning och funktioner och återanslut endast om leverantören kräver förnyat samtycke. Ett internt tjänstefel är ingen anledning att återskapa en frisk anslutning.

- [Autentisering och behörigheter](https://sosoapi.ai/sv/docs/authentication)

- [Fullständig API-referens](https://sosoapi.ai/sv/docs/api)

## 400-validering och versionsavvikelse

Läs svarskroppen och valideringens fältsökvägar. Valideringsfel kan innehålla ZodError; hanterarfel kan använda fälten error, message och code. Jämför begäran med installerat kontrakt och uppdatera klientpaketet vid behov. Åtgärda fälten som anges i felet utan att ta bort obligatoriska värden eller lägga till filter utan stöd.

```
npx sosoapi api contract --route /studio-api/scheduled-posts/
```

## 409, 429, 5xx eller en skrivning som fått timeout

Vid 409 läser du resursens senaste version och tillgängliga åtgärder innan du ändrar den. Vid 429 väntar du enligt Retry-After och minskar samtidigheten. Om en skrivning får timeout eller returnerar 5xx, behåll dess ID och kontrollera först befintligt resultat: servern kan ha accepterat den innan anslutningen bröts.

Försök igen endast när åtgärden och dess aktuella tillstånd tillåter det. Behåll samma nyckel för samma payload och skapa ingen ersättning för att kringgå ett osäkert resultat. Åtgärda autentiseringsfel före nya försök. Om ett bakgrundsjobb fortfarande väntar kan dess status redan innehålla ett körningsfel som bör kontrolleras.

- [Publiceringsreferens](https://sosoapi.ai/sv/docs/publishing-api-reference)

## Uppladdningsproblem eller problem med verktygsidentifiering

Lokal uppladdning godtar stödda mediefiler upp till 500 MiB från arbetskatalogen, tempmappen, Pictures/Movies/Videos eller mappar i SOSOAPI_UPLOAD_ROOTS. Punktmappar och symboliska länkar som lämnar dessa rotmappar avvisas. Lägg till den specifika mediemapp du behöver i stället för hela hemkatalogen. En HTTP-anslutning kan inte läsa lokala filer.

Om verktyg saknas, anslut klienten igen och jämför dess profil och anslutningstyp med referensen. Kontrollera att verktygen är laddade i aktuell konversation; enbart ett sparat servernamn bekräftar inte det.

- [MCP-verktygsreferens](https://sosoapi.ai/sv/docs/mcp)

## Dela användbar felsökningsinformation säkert

Dela åtgärdsnamn, tid, HTTP-status, säker felkod och request_id eller x-request-id om det finns. Ta med CLI-version och om du använde lokal eller fjärransluten MCP. Ta bort token, cookies, auktoriseringslänkar, signerade medie-URL:er, kundinnehåll och privata ID:n. Dela relevant fel i stället för en uppgiftsfil eller ett helt svar.

- [Kontakta SosoAPI](https://sosoapi.ai/sv/contact)