De API en de koppeling met Claude

Dit heb je nodig

• Een zakelijk account
• Scans die je naar je portaal hebt gestuurd
• Iemand die met software werkt

Woorden die je misschien niet kent

API

Een koppeling waarmee een ander computerprogramma je scans kan ophalen. Voor bedrijven met eigen software.

Claude

Een AI-assistent van het bedrijf Anthropic. Met de API kan hij je scans ophalen en gebruiken.

Pand

In de app: één adres, zoals een huis of een appartement, met per verdieping de scans.

Polycam

Een andere app om met een iPhone te scannen. Veel tekenaars werken met de bestanden van Polycam.

Portaal

Je eigen plek online, op portaal.maximilius.com. Daar staan de scans die je verstuurt.

Alle moeilijke woorden

Stap voor stap

Liever samen? Doe het stap voor stap met de assistent

1. 1

   Stap 1 van 3

   Wat je ziet

   Op Panden staat bij een verdieping "verstuurd".

   Wat je doet

   Stuur je scans naar je portaal. Alleen wat verstuurd is, staat in de API.

2. 2

   Stap 2 van 3

   Wat je ziet

   De supportpagina met het formulier.

   Wat je doet

   Vraag een sleutel aan op de supportpagina. Wij maken hem voor je.

3. 3

   Stap 3 van 3

   Wat je ziet

   Je sleutel: een code die begint met scan_.

   Wat je doet

   Geef de sleutel aan je software of aan Claude. Hij ziet alleen jouw scans.

Voor de techneut: de routes

Alle routes geven JSON. Elke aanvraag (behalve health) met Authorization: Bearer scan_…. De vorm volgt de API van Polycam.

• GET /v1/health: of de API draait, zonder sleutel.
• GET /v1/captures: je opnamen, nieuwste eerst; filter met limit, cursor, createdAfter, tag, externalId, pand, project.
• GET /v1/captures/{id}: één opname met pand, verdieping, m² en de ruimten.
• PATCH /v1/captures/{id}: naam, omschrijving, tags of je eigen kenmerk wijzigen.
• GET /v1/captures/{id}/export: een downloadlink per bestand, een uur geldig.
• GET /v1/projects en GET /v1/projects/{id}: je panden met hun opnamen.

Fouten zijn { "error": "…" } met een gewone HTTP-status (401, 403, 404). Een voorbeeld met curl staat bij API op de beginpagina.

Gelukt?

Dan haalt je software of Claude de scans zelf op: de plattegrond in een offerte, de m² in een berekening.

Lukt het niet?

De API zegt 401 "Invalid API token".

De sleutel klopt niet, of is ingetrokken. Een sleutel begint met scan_ en heeft 64 tekens erna.

Mijn scan staat er niet in.

Hij is nog niet verstuurd. Kijk op Panden of er "verstuurd" bij staat.

Zie ook

• Je scan naar je portaal sturen