Developer docs

Futuhire API

REST + webhooks. Developer-docs nu al open — geen demo-call nodig. Volledige OpenAPI-spec en SDK's volgen.

Bearer-token

Supabase-session of API-key uit Instellingen. Per organisatie gescoped.

REST + JSON

Voorspelbare endpoints, gestructureerde antwoorden, streaming waar relevant.

Webhooks (HMAC)

Events voor kandidaat-/AI-/journey-mutaties met X-Futuhire-Signature.

Authenticatie

Stuur Authorization: Bearer ... mee op elk request. Eén token = één organisatie. Beheer keys in Instellingen.

# Authenticatie via Bearer-token (Supabase session of API-key)
curl -X GET https://api.futuhire.com/v1/jobs \
  -H "Authorization: Bearer $FUTUHIRE_TOKEN"

AI-rewrite (streaming)

Antwoordt met text/plain stream. Brand voice wordt automatisch toegepast als er voor de organisatie een actieve voice is.

curl -X POST https://api.futuhire.com/v1/jobs/{id}/rewrite \
  -H "Authorization: Bearer $FUTUHIRE_TOKEN" \
  -H "Content-Type: application/json"
# stream van text/plain met de herschrijving (Claude Sonnet, brand-voice).

CV-upload + AI-extractie

curl -X POST https://api.futuhire.com/v1/candidates/{id}/cv \
  -H "Authorization: Bearer $FUTUHIRE_TOKEN" \
  -F "file=@./resume.pdf"
# Geeft { candidate, profile } terug — incl. extractie skills/ervaring.

Webhooks

# Configureer de URL in de Futuhire-cockpit -> Integraties.
# Events: candidate.created, ai_generation.created, journey_run.completed
# Verifieer X-Futuhire-Signature (HMAC SHA-256 met je webhook-secret).

Endpoints (samenvatting)

Methode	Pad	Beschrijving
GET	/v1/jobs	Lijst vacatures (org-scoped).
POST	/v1/jobs	Vacature aanmaken.
POST	/v1/jobs/{id}/rewrite	AI-herschrijving (streaming).
POST	/v1/jobs/{id}/variants	A/B-varianten (zakelijk + wervend).
GET	/v1/candidates	Lijst kandidaten (filter status, q).
POST	/v1/candidates/{id}/cv	CV uploaden + AI-extractie.
POST	/v1/candidates/{id}/share	Token + URL voor opdrachtgever (default 7d).
GET	/v1/candidates/search?q=…	Semantische search via OpenAI-embeddings.
POST	/v1/conversations	Start intake (simulator / whatsapp / email / sms).
POST	/v1/conversations/{id}/messages	Inbound bericht (kandidaat).
POST	/v1/conversations/{id}/whisper	AI-suggestie zonder versturen.

Volledige OpenAPI-spec en SDK's komen later. Tot die tijd: alles wat de cockpit gebruikt staat onder dezelfde routes — vervang /api/ door /v1/ in de toekomst.