{"title":"API FAQ","slug":"api-faq","category":"faq","summary":"Vanliga API-frågor — autentisering, hastighetsgränser, felhantering, endpoint-upptäckning.","audience":["human","llm"],"tags":["faq","api","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":348,"read_minutes":2,"lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# API FAQ\n\nVanliga frågor om Synapse API.\n\n## Hur autentiserarar jag?\n\nTvå metoder:\n\n1. **Mind Key** (för data-endpoints): `Authorization: Bearer mk_...`\n2. **JWT** (för konto-endpoints): `Authorization: Bearer eyJ...`\n\nEller via queryparameter (60 req/min-gräns): `?key=mk_...`\n\nSe [Autentisering](/docs/getting-started/authentication).\n\n## Vad är skillnaden mellan Mind Key och JWT?\n\n- **Mind Key**: klientomfattande, löper aldrig ut, för minnes-/chatt-/uppgiftsdata\n- **JWT**: användaromfattande, 7 dagars giltighet, för konto-/mind-hantering\n\nSe [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt).\n\n## Varför får jag 401 Unauthorized?\n\nVanliga orsaker:\n\n1. Saknad `Authorization`-header\n2. Ogiltig Mind Key (verifiera att den börjar med `mk_`)\n3. Användning av en JWT där en Mind Key krävs (eller tvärtom)\n4. Mind Key har återkallats\n\n**Lösning:** Verifiera din token. Se [Autentisering](/docs/getting-started/authentication).\n\n## Varför får jag 404 Not Found?\n\nNi använde en felaktig endpointsökväg. Synapse har endast de sökvägar som listas\ni `GET /endpoints`.\n\n**Lösning:** Anropa `GET /endpoints` för att se alla giltiga sökvägar. Gissa inte.\n\n## Varför får jag 429 Too Many Requests?\n\nNi använder `?key=`-queryparameter-autentisering, som är begränsad till 60/min.\n\n**Lösning:** Byt till `Authorization: Bearer`-header (ingen hastighetsgräns).\n\nSe [Hastighetsgränser](/docs/api/rate-limits).\n\n## Hur listar jag alla endpoints?\n\n```bash\ncurl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text\n```\n\n## Hur hittar jag rätt endpoint?\n\n1. Kontrollera `GET /endpoints` för den maskinläsbara listan\n2. Kontrollera `GET /help` för fullständig API-dokumentation\n3. Bläddra i `GET /docs` för dokumentationssystemet\n4. Använd `GET /openapi.json` för OpenAPI 3.0-specifikation\n\n## Kan jag använda GET istället för POST?\n\nVissa POST-endpoints har GET-motsvarigheter för URL-endast-verktyg:\n\n- `POST /memory` ↔ `GET /memory/store?content=...`\n- `POST /mind/task` ↔ `GET /mind/task?title=...`\n- `POST /chat/reply` ↔ `GET /chat/reply?content=...`\n\nKontrollera `GET /endpoints` för tillgängliga GET-varianter.\n\n## Hur hanterar jag fel?\n\nAlla fel returnerar JSON:\n\n```json\n{\n \"statusCode\": 401,\n \"error\": \"Unauthorized\",\n \"message\": \"Mind Key fehlt oder ungültig.\",\n \"docs\": \"https://synapse.schaefer.zone/docs/getting-started/authentication\"\n}\n```\n\nSe [Fel & felhantering](/docs/api/errors).\n\n## Vad är gränsen för begärans body?\n\n10 MB. För större payloads (t.ex. filuppladdningar), använd multipart-endpoints.\n\n## Stöder API:et CORS?\n\nJa. Alla endpoints returnerar:\n\n```\nAccess-Control-Allow-Origin: *\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\nAccess-Control-Allow-Headers: Authorization, Content-Type, X-Synapse-JWT\n```\n\n## Finns det ett SDK?\n\nJa:\n\n- **Node.js**: `npm install synapse-memory-sdk`\n- **MCP**: `npx -y synapse-mcp-api@latest`\n\nSe [API-översikt](/docs/api/overview) för detaljer.\n\n## Hur paginerar jag?\n\nAnvänd `?limit=` och `?offset=`:\n\n```bash\ncurl \".../memory?limit=50&offset=100\"\n```\n\nStandardgräns: 100. Max: 500.\n\n## Kan jag filtrera minnen efter kategori eller tagg?\n\nJa:\n\n```bash\ncurl \".../memory?category=project\"\ncurl \".../memory?tag=docker\"\ncurl \".../memory/by-tag?tag=production\"\n```\n\n## Hur söker jag bland minnen?\n\nPå två sätt:\n\n1. **FTS5 nyckelordssökning**: `GET /memory/search?q=docker+swarm`\n2. **Semantisk sökning**: `GET /memory/semantic-search?q=container+orchestration`\n\nSe [FTS5-sökning](/docs/concepts/fts5-search) och [Semantisk sökning](/docs/concepts/semantic-search).\n\n## Hur uppdaterar jag ett minne?\n\nPOST `/memory` med samma `category` + `key` — det befintliga minnet uppdateras,\ninte dupliceras.\n\n```bash\n# Initial store\ncurl -X POST .../memory -d '{\"category\":\"fact\",\"key\":\"user_name\",\"content\":\"Michael\"}'\n\n# Update (same key)\ncurl -X POST .../memory -d '{\"category\":\"fact\",\"key\":\"user_name\",\"content\":\"Michael Schäfer\"}'\n```\n\n## Hur tar jag bort ett minne?\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Kan jag ta bort i bulk?\n\nJa:\n\n```bash\ncurl -X POST .../memory/bulk-delete \\\n -d '{\"ids\": [\"mem_001\", \"mem_002\", \"mem_003\"]}'\n```\n\n## Nästa steg\n\n- [API-översikt](/docs/api/overview)\n- [Fel & felhantering](/docs/api/errors)\n- [Autentisering](/docs/getting-started/authentication)\n","content_html":"

API FAQ

\n

Vanliga frågor om Synapse API.

\n

Hur autentiserarar jag?

\n

Två metoder:

\n
    \n
  1. Mind Key (för data-endpoints): Authorization: Bearer mk_...
    2. \n
  2. JWT (för konto-endpoints): Authorization: Bearer eyJ...
    3. \n
\n

Eller via queryparameter (60 req/min-gräns): ?key=mk_...

\n

Se Autentisering.

\n

Vad är skillnaden mellan Mind Key och JWT?

\n\n

Se Mind Key vs JWT.

\n

Varför får jag 401 Unauthorized?

\n

Vanliga orsaker:

\n
    \n
  1. Saknad Authorization-header
    2. \n
  2. Ogiltig Mind Key (verifiera att den börjar med mk_)
    3. \n
  3. Användning av en JWT där en Mind Key krävs (eller tvärtom)
    4. \n
  4. Mind Key har återkallats
    5. \n
\n

Lösning: Verifiera din token. Se Autentisering.

\n

Varför får jag 404 Not Found?

\n

Ni använde en felaktig endpointsökväg. Synapse har endast de sökvägar som listas\ni GET /endpoints.

\n

Lösning: Anropa GET /endpoints för att se alla giltiga sökvägar. Gissa inte.

\n

Varför får jag 429 Too Many Requests?

\n

Ni använder ?key=-queryparameter-autentisering, som är begränsad till 60/min.

\n

Lösning: Byt till Authorization: Bearer-header (ingen hastighetsgräns).

\n

Se Hastighetsgränser.

\n

Hur listar jag alla endpoints?

\n
curl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text

Hur hittar jag rätt endpoint?

\n
    \n
  1. Kontrollera GET /endpoints för den maskinläsbara listan
    2. \n
  2. Kontrollera GET /help för fullständig API-dokumentation
    3. \n
  3. Bläddra i GET /docs för dokumentationssystemet
    4. \n
  4. Använd GET /openapi.json för OpenAPI 3.0-specifikation
    5. \n
\n

Kan jag använda GET istället för POST?

\n

Vissa POST-endpoints har GET-motsvarigheter för URL-endast-verktyg:

\n\n

Kontrollera GET /endpoints för tillgängliga GET-varianter.

\n

Hur hanterar jag fel?

\n

Alla fel returnerar JSON:

\n
{\n  "statusCode": 401,\n  "error": "Unauthorized",\n  "message": "Mind Key fehlt oder ungültig.",\n  "docs": "https://synapse.schaefer.zone/docs/getting-started/authentication"\n}

Se Fel & felhantering.

\n

Vad är gränsen för begärans body?

\n

10 MB. För större payloads (t.ex. filuppladdningar), använd multipart-endpoints.

\n

Stöder API:et CORS?

\n

Ja. Alla endpoints returnerar:

\n
Access-Control-Allow-Origin: *\nAccess-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS\nAccess-Control-Allow-Headers: Authorization, Content-Type, X-Synapse-JWT

Finns det ett SDK?

\n

Ja:

\n\n

Se API-översikt för detaljer.

\n

Hur paginerar jag?

\n

Använd ?limit= och ?offset=:

\n
curl ".../memory?limit=50&offset=100"

Standardgräns: 100. Max: 500.

\n

Kan jag filtrera minnen efter kategori eller tagg?

\n

Ja:

\n
curl ".../memory?category=project"\ncurl ".../memory?tag=docker"\ncurl ".../memory/by-tag?tag=production"

Hur söker jag bland minnen?

\n

På två sätt:

\n
    \n
  1. FTS5 nyckelordssökning: GET /memory/search?q=docker+swarm
    2. \n
  2. Semantisk sökning: GET /memory/semantic-search?q=container+orchestration
    3. \n
\n

Se FTS5-sökning och Semantisk sökning.

\n

Hur uppdaterar jag ett minne?

\n

POST /memory med samma category + key — det befintliga minnet uppdateras,\ninte dupliceras.

\n
# Initial store\ncurl -X POST .../memory -d '{"category":"fact","key":"user_name","content":"Michael"}'\n\n# Update (same key)\ncurl -X POST .../memory -d '{"category":"fact","key":"user_name","content":"Michael Schäfer"}'

Hur tar jag bort ett minne?

\n
curl -X DELETE -H "Authorization: Bearer $KEY" \\\n     https://synapse.schaefer.zone/memory/mem_001

Kan jag ta bort i bulk?

\n

Ja:

\n
curl -X POST .../memory/bulk-delete \\\n  -d '{"ids": ["mem_001", "mem_002", "mem_003"]}'

Nästa steg

\n\n","urls":{"html":"/docs/faq/api-faq","text":"/docs/faq/api-faq?format=text","json":"/docs/faq/api-faq?format=json","llm":"/docs/faq/api-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}