REST API

Bouw verder op uw Skimle-projecten

JSON-endpoints om projectdata te lezen en te schrijven en om een project van begin tot eind uit te voeren. Authenticeer met een Bearer-sleutel, stuur een actie en ontvang JSON terug.

Aan de slag in drie stappen

Van nul tot uw eerste geauthenticeerde aanroep.

1

Maak een API-sleutel aan

Een projectsleutel geeft toegang tot één project. Een accountsleutel geeft toegang tot één team en kan daarin projecten aanmaken. Beide zijn er met lees- en bewerkrechten.

  1. 1. Open de pagina met API-sleutels
  2. 2. Kies het project waartoe de sleutel toegang moet hebben en kies lees- of bewerkrechten
  3. 3. Kopieer de sleutel: Skimle bewaart alleen de hash

Kopieer de sleutel meteen.

De volledige sleutel wordt één keer getoond bij het aanmaken. Nadat u het venster sluit, blijft aan onze kant alleen de hash over. Een verloren sleutel moet opnieuw worden uitgegeven.

2

Stuur uw eerste verzoek

Geef de sleutel mee als Bearer-token en de actie in de JSON-body. Elk endpoint neemt JSON aan en geeft JSON terug.

curl -X POST https://app.skimle.com/api/skimle-read \
  -H "Authorization: Bearer skm_…r" \
  -H "Content-Type: application/json" \
  -d '{ "action": "get_categories" }'

Leessleutels eindigen op r, bewerksleutels op e. Projectsleutels roepen /api/skimle-read en /api/skimle-write aan. Accountsleutels roepen /api/skimle-account aan.

3

Open de API-referentie

Bekijk alle endpoints met beschrijvingen, de vorm van verzoeken en een paneel om ze uit te proberen. Elke route accepteert een body als discriminated union op basis van action.

De ruwe OpenAPI 3.1-specificatie is beschikbaar op /api/openapi.json.

Klaar om te bouwen?

Beheer uw projectsleutels of bekijk de MCP-server voor agentische clients.