{"openapi":"3.0.3","info":{"title":"Kortvarsel API","version":"1.0","description":"Fyll avbestilte timer automatisk. Autentiser med API-nøkkel fra Innstillinger → Utviklere: `Authorization: Bearer kv_live_…`. Rate limit: 60 kall/min. Mobilnumre kan aldri hentes ut i bulk."},"servers":[{"url":"https://kortvarsel.no/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"kv_live_…"}}},"paths":{"/openings":{"post":{"summary":"Opprett hull (utlyses etter matching-reglene)","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resource_id","starts_at"],"properties":{"resource_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time"},"duration_min":{"type":"integer","default":30},"extra":{"type":"object","additionalProperties":{"type":"string"},"description":"Vertikal-avhengig, f.eks. {\"klasse\": \"B\"}"}}}}}},"responses":{"201":{"description":"Opprettet. SMS 21–07 køes til 07:00."}}}},"/openings/{id}":{"get":{"summary":"Status: open / filled / expired / withdrawn","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Ukjent id"}}},"delete":{"summary":"Trekk tilbake utlysningen","security":[{"apiKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trukket tilbake"}}}},"/waitlist":{"post":{"summary":"Legg til liste-oppføring (krever dokumentert samtykke)","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","phone","consent","consent_at"],"properties":{"name":{"type":"string"},"phone":{"type":"string","example":"+4790000000"},"consent":{"type":"boolean","description":"Må være true"},"consent_at":{"type":"string","format":"date-time"},"day_prefs":{"type":"object"},"preferred_resource_id":{"type":"string"},"extra":{"type":"object"}}}}}},"responses":{"201":{"description":"Opprettet/oppdatert (upsert på telefon)"}}},"get":{"summary":"Egne oppføringer (mobilnumre maskert)","security":[{"apiKey":[]}],"responses":{"200":{"description":"OK"}}}},"/appointments":{"post":{"summary":"Registrer avtale (aktiverer påminnelse + auto-utlysning)","security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["resource_id","starts_at"],"properties":{"resource_id":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"duration_min":{"type":"integer","default":30},"customer_name":{"type":"string"},"customer_phone":{"type":"string"}}}}}},"responses":{"201":{"description":"Opprettet"}}}}},"x-webhooks":{"description":"Registrer URL i Innstillinger → Utviklere. Payload signeres med HMAC-SHA256 i X-Kortvarsel-Signature (sha256=<hex av body med webhook-secret>). Retry med backoff: 1, 5, 30, 120, 720 min.","events":["opening.filled","opening.expired","waitlist.entry.opted_out","appointment.cancelled_by_customer"]}}