Je eerste API-verzoek

1. Neem het basisadres uit je eigen MANE

Open Instellingen → API & webhooks en kopieer het basisadres. Het eindigt op /api/v1. In deze voorbeelden vervang je jouw-werkruimte.maneworks.com door dat adres. De sleutel hoort altijd bij één werkruimte; een adres van een andere tenant geeft geen toegang.

Maak een sleutel met workspace:read, schema:read, projects:read en projects:write voor dit voorbeeld. Bewaar de volledige sleutel meteen als geheim in je toepassing. Gebruik geen echte sleutel in gedeelde screenshots of broncode.

2. Controleer eerst de werkruimte

Doe een GET-verzoek met de Authorization-header. Het resultaat bevat data, revision en requestId. De responseheader ETag bevat dezelfde revisie. Het onderstaande token is een placeholder.

GET https://jouw-werkruimte.maneworks.com/api/v1/workspace
Authorization: Bearer <JOUW_SERVICESLEUTEL>

{
  "data": {"id": "co_…", "name": "Jouw MANE", "revision": 12},
  "revision": 12,
  "requestId": "…"
}

3. Lees objecten en projecten

GET /schema toont de inrichting, endpoints en veldpaden. GET /projects?limit=10 toont de eerste projecten of trajecten. Controleer de data voordat je wijzigingen toevoegt. De naam op het scherm en het technische endpoint hoeven niet hetzelfde woord te gebruiken.

GET https://jouw-werkruimte.maneworks.com/api/v1/schema
Authorization: Bearer <JOUW_SERVICESLEUTEL>

GET https://jouw-werkruimte.maneworks.com/api/v1/projects?limit=10
Authorization: Bearer <JOUW_SERVICESLEUTEL>

4. Maak één fictief project aan

Gebruik POST, JSON en de revisie die je net hebt gelezen als If-Match. De Idempotency-Key kies je één keer voor deze specifieke wijziging. Maak bij een echte koppeling een stabiele sleutel op basis van bijvoorbeeld de externe aanvraag-ID en de handeling.

De voorbeeldrevisie 12 is illustratief. Gebruik de actuele revisie uit jouw antwoord. MANE maakt de dossier-ID; stuur bij POST geen eigen id mee.

POST https://jouw-werkruimte.maneworks.com/api/v1/projects
Authorization: Bearer <JOUW_SERVICESLEUTEL>
Content-Type: application/json
If-Match: "12"
Idempotency-Key: aanvraag-demo-001-project

{"name":"Fictieve aanvraag","place":"Zwolle"}

5. Controleer de opgeslagen uitkomst

Een geslaagde POST geeft 201 met de nieuwe data.id en revision terug. Lees daarna GET /projects/<id>. Bewaar de MANE-ID bij je externe referentie. Een antwoord 200 bij een herhaald identiek verzoek kan replayed:true bevatten: je eerste wijziging is dan herkend en niet opnieuw aangemaakt.

Een PATCH wijzigt alleen meegegeven velden; geneste lijsten of objecten die je meegeeft vervangen hun oude waarde. Bij een conflict lees je eerst opnieuw en beoordeel je de wijziging. Verhoog If-Match nooit op goed geluk.