{"title":"API-FAQ","slug":"api-faq","category":"faq","summary":"Veelgestelde API-vragen — auth, ratelimits, foutafhandeling, eindpunt-ontdekking.","audience":["human","llm"],"tags":["faq","api","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":359,"read_minutes":2,"lang":"nl","translated":true,"requested_lang":"nl","content_markdown":"\n# API-FAQ\n\nVeelgestelde vragen over de Synapse API.\n\n## Hoe authenticeer ik?\n\nTwee methoden:\n\n1. **Mind Key** (voor data-eindpunten): `Authorization: Bearer mk_...`\n2. **JWT** (voor account-eindpunten): `Authorization: Bearer eyJ...`\n\nOf via queryparameter (limiet van 60 aanvragen/min): `?key=mk_...`\n\nZie [Authenticatie](/docs/getting-started/authentication).\n\n## Wat is het verschil tussen Mind Key en JWT?\n\n- **Mind Key**: tenant-scoped, vervalt nooit, voor memory/chat/tasks-data\n- **JWT**: gebruiker-scoped, vervalt na 7 dagen, voor account/mind-beheer\n\nZie [Mind Key vs JWT](/docs/getting-started/mind-key-vs-jwt).\n\n## Waarom krijg ik 401 Unauthorized?\n\nVeelvoorkomende oorzaken:\n\n1. Ontbrekende `Authorization`-header\n2. Ongeldige Mind Key (verifieer dat deze begint met `mk_`)\n3. Een JWT gebruiken waar een Mind Key vereist is (of omgekeerd)\n4. Mind Key is ingetrokken\n\n**Oplossing:** Verifieer uw token. Zie [Authenticatie](/docs/getting-started/authentication).\n\n## Waarom krijg ik 404 Not Found?\n\nU heeft een verkeerd eindpuntpad gebruikt. Synapse heeft alleen de paden die in\n`GET /endpoints` staan.\n\n**Oplossing:** Roep `GET /endpoints` aan om alle geldige paden te zien. Raad niet.\n\n## Waarom krijg ik 429 Too Many Requests?\n\nU gebruikt `?key=`-queryparameter-auth, die is gelimiteerd tot 60/min.\n\n**Oplossing:** Schakel over naar `Authorization: Bearer`-header (geen ratelimit).\n\nZie [Ratelimits](/docs/api/rate-limits).\n\n## Hoe toon ik alle eindpunten?\n\n```bash\ncurl https://synapse.schaefer.zone/endpoints\ncurl https://synapse.schaefer.zone/endpoints?format=text\n```\n\n## Hoe vind ik het juiste eindpunt?\n\n1. Controleer `GET /endpoints` voor de machineleesbare lijst\n2. Controleer `GET /help` voor volledige API-documentatie\n3. Blader door `GET /docs` voor het documentatiesysteem\n4. Gebruik `GET /openapi.json` voor de OpenAPI 3.0-specificatie\n\n## Kan ik GET gebruiken in plaats van POST?\n\nSommige POST-eindpunten hebben GET-equivalenten voor URL-only tools:\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\nControleer `GET /endpoints` voor beschikbare GET-varianten.\n\n## Hoe handel ik fouten af?\n\nAlle fouten retourneren 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\nZie [Fouten & Foutafhandeling](/docs/api/errors).\n\n## Wat is de limiet voor requestbody's?\n\n10 MB. Voor grotere payloads (bijv. bestandsuploads), gebruik de multipart-eindpunten.\n\n## Ondersteunt de API CORS?\n\nJa. Alle eindpunten retourneren:\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## Is er een SDK?\n\nJa:\n\n- **Node.js**: `npm install synapse-memory-sdk`\n- **MCP**: `npx -y synapse-mcp-api@latest`\n\nZie [API-overzicht](/docs/api/overview) voor details.\n\n## Hoe pagineer ik?\n\nGebruik `?limit=` en `?offset=`:\n\n```bash\ncurl \".../memory?limit=50&offset=100\"\n```\n\nStandaardlimiet: 100. Maximum: 500.\n\n## Kan ik herinneringen filteren op categorie of tag?\n\nJa:\n\n```bash\ncurl \".../memory?category=project\"\ncurl \".../memory?tag=docker\"\ncurl \".../memory/by-tag?tag=production\"\n```\n\n## Hoe doorzoek ik herinneringen?\n\nTwee manieren:\n\n1. **FTS5 trefwoordzoekopdracht**: `GET /memory/search?q=docker+swarm`\n2. **Semantisch zoeken**: `GET /memory/semantic-search?q=container+orchestration`\n\nZie [FTS5-zoekopdracht](/docs/concepts/fts5-search) en [Semantisch zoeken](/docs/concepts/semantic-search).\n\n## Hoe werk ik een herinnering bij?\n\nPOST `/memory` met dezelfde `category` + `key` — de bestaande herinnering wordt\nbijgewerkt, niet gedupliceerd.\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## Hoe verwijder ik een herinnering?\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer $KEY\" \\\n https://synapse.schaefer.zone/memory/mem_001\n```\n\n## Kan ik in bulk verwijderen?\n\nJa:\n\n```bash\ncurl -X POST .../memory/bulk-delete \\\n -d '{\"ids\": [\"mem_001\", \"mem_002\", \"mem_003\"]}'\n```\n\n## Volgende stappen\n\n- [API-overzicht](/docs/api/overview)\n- [Fouten & Foutafhandeling](/docs/api/errors)\n- [Authenticatie](/docs/getting-started/authentication)\n","content_html":"

API-FAQ

\n

Veelgestelde vragen over de Synapse API.

\n

Hoe authenticeer ik?

\n

Twee methoden:

\n
    \n
  1. Mind Key (voor data-eindpunten): Authorization: Bearer mk_...
    2. \n
  2. JWT (voor account-eindpunten): Authorization: Bearer eyJ...
    3. \n
\n

Of via queryparameter (limiet van 60 aanvragen/min): ?key=mk_...

\n

Zie Authenticatie.

\n

Wat is het verschil tussen Mind Key en JWT?

\n\n

Zie Mind Key vs JWT.

\n

Waarom krijg ik 401 Unauthorized?

\n

Veelvoorkomende oorzaken:

\n
    \n
  1. Ontbrekende Authorization-header
    2. \n
  2. Ongeldige Mind Key (verifieer dat deze begint met mk_)
    3. \n
  3. Een JWT gebruiken waar een Mind Key vereist is (of omgekeerd)
    4. \n
  4. Mind Key is ingetrokken
    5. \n
\n

Oplossing: Verifieer uw token. Zie Authenticatie.

\n

Waarom krijg ik 404 Not Found?

\n

U heeft een verkeerd eindpuntpad gebruikt. Synapse heeft alleen de paden die in\nGET /endpoints staan.

\n

Oplossing: Roep GET /endpoints aan om alle geldige paden te zien. Raad niet.

\n

Waarom krijg ik 429 Too Many Requests?

\n

U gebruikt ?key=-queryparameter-auth, die is gelimiteerd tot 60/min.

\n

Oplossing: Schakel over naar Authorization: Bearer-header (geen ratelimit).

\n

Zie Ratelimits.

\n

Hoe toon ik alle eindpunten?

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

Hoe vind ik het juiste eindpunt?

\n
    \n
  1. Controleer GET /endpoints voor de machineleesbare lijst
    2. \n
  2. Controleer GET /help voor volledige API-documentatie
    3. \n
  3. Blader door GET /docs voor het documentatiesysteem
    4. \n
  4. Gebruik GET /openapi.json voor de OpenAPI 3.0-specificatie
    5. \n
\n

Kan ik GET gebruiken in plaats van POST?

\n

Sommige POST-eindpunten hebben GET-equivalenten voor URL-only tools:

\n\n

Controleer GET /endpoints voor beschikbare GET-varianten.

\n

Hoe handel ik fouten af?

\n

Alle fouten retourneren 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}

Zie Fouten & Foutafhandeling.

\n

Wat is de limiet voor requestbody's?

\n

10 MB. Voor grotere payloads (bijv. bestandsuploads), gebruik de multipart-eindpunten.

\n

Ondersteunt de API CORS?

\n

Ja. Alle eindpunten retourneren:

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

Is er een SDK?

\n

Ja:

\n\n

Zie API-overzicht voor details.

\n

Hoe pagineer ik?

\n

Gebruik ?limit= en ?offset=:

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

Standaardlimiet: 100. Maximum: 500.

\n

Kan ik herinneringen filteren op categorie of tag?

\n

Ja:

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

Hoe doorzoek ik herinneringen?

\n

Twee manieren:

\n
    \n
  1. FTS5 trefwoordzoekopdracht: GET /memory/search?q=docker+swarm
    2. \n
  2. Semantisch zoeken: GET /memory/semantic-search?q=container+orchestration
    3. \n
\n

Zie FTS5-zoekopdracht en Semantisch zoeken.

\n

Hoe werk ik een herinnering bij?

\n

POST /memory met dezelfde category + key — de bestaande herinnering wordt\nbijgewerkt, niet gedupliceerd.

\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"}'

Hoe verwijder ik een herinnering?

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

Kan ik in bulk verwijderen?

\n

Ja:

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

Volgende stappen

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