{"openapi":"3.1.0","info":{"title":"Verifiserer API","description":"API for verifisering av credentials (Verifiable Credentials) via OpenID4VP. Krever Basic Auth.","version":"v2"},"servers":[{"url":"https://lommebok.test.digipost.no/verifiserer","description":"Generated server url"}],"tags":[{"name":"Verifisering","description":"Opprett og hent status for verifisering av credentials (v2)"}],"paths":{"/internal/authorizationrequest/create":{"post":{"tags":["authorization-request-controller"],"operationId":"createAuthorizationRequest","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAuthorizationRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v2/verification":{"post":{"tags":["Verifisering"],"summary":"Opprett verifisering","description":"Oppretter en ny verifiseringsforespørsel. Sender varsel til mottaker via valgt leveringsmetode. Mottaker blir bedt om å presentere etterspurte credentials via OpenID4VP.","operationId":"createVerification","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVerification"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVerificationResponse"}}}}}}},"/api/v2/verification/{verificationId}/authorization-request":{"post":{"tags":["Verifisering"],"operationId":"createAuthorizationRequest_1","parameters":[{"name":"verificationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationRequestResponse"}}}}}}},"/ping":{"get":{"tags":["Helsesjekk"],"summary":"Ping","description":"Svarer alltid med 200 gitt at applikasjonen er oppe og kjører.","operationId":"internalPing","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ping"}}}}}}},"/internal/authorizationrequest/{digipostSenderId}/{verificationId}/status":{"get":{"tags":["authorization-request-controller"],"operationId":"getPresentationStatus","parameters":[{"name":"digipostSenderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"verificationId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/VerificationId"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/v2/verification/{verificationId}":{"get":{"tags":["Verifisering"],"summary":"Hent verifiseringsstatus","description":"Henter status og eventuelt resultat for en verifisering. Poll dette endepunktet for å følge med på om mottaker har presentert sine credentials. Mulige statuser: PENDING, ACTIVE, PRESENTED, FAILED.","operationId":"getVerification","parameters":[{"name":"verificationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponse"}}}}}}},"/api/ping":{"get":{"tags":["Helsesjekk"],"summary":"Ping","description":"Svarer alltid med 200 gitt at applikasjonen er oppe og kjører.","operationId":"externalPing","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ping"}}}}}}}},"components":{"schemas":{"CreateAuthorizationRequestDTO":{"type":"object","properties":{"verificationId":{"type":"string","format":"uuid"},"digipostSenderId":{"type":"integer","format":"int64"}},"required":["verificationId"]},"CreateVerification":{"type":"object","properties":{"verificationId":{"type":"string","format":"uuid","example":"your-verification-uuid"},"credentialQuery":{"$ref":"#/components/schemas/CredentialQuery"},"delivery":{"$ref":"#/components/schemas/Delivery"}},"required":["credentialQuery","delivery","verificationId"]},"CredentialQuery":{"type":"object","properties":{"credentials":{"type":"array","items":{"$ref":"#/components/schemas/DcqlCredential"},"minItems":1}},"required":["credentials"]},"DcqlClaimQuery":{"type":"object","properties":{"path":{"type":"array","example":["name"],"items":{"type":"string"},"minItems":1}},"required":["path"]},"DcqlCredential":{"type":"object","properties":{"id":{"type":"string","example":"my-credential","minLength":1},"format":{"type":"string","example":"dc+sd-jwt","minLength":1},"meta":{"$ref":"#/components/schemas/DcqlCredentialMeta"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/DcqlClaimQuery"}}},"required":["format","id"]},"DcqlCredentialMeta":{"type":"object","properties":{"vct_values":{"type":"array","example":["https://example.com/my-credential-type"],"items":{"type":"string"}}},"required":["vct_values"]},"Delivery":{"type":"object","properties":{"method":{"type":"string","enum":["digipost","direct"]},"recipientId":{"type":"string","example":"personnummer-eller-orgnummer"},"presentationNoticeTitle":{"type":"string","example":"Bekreft din utdanning"},"presentationNoticeBody":{"type":"string","example":"Vi trenger å verifisere din utdanning i forbindelse med søknaden din."}},"required":["method"]},"CreateVerificationResponse":{"type":"object","properties":{"verificationId":{"type":"string","format":"uuid","example":"your-verification-uuid"}}},"AuthorizationRequestResponse":{"type":"object","properties":{"authorizationRequestUri":{"type":"string","example":"openid4vp://?request_uri=https..."}}},"Ping":{"type":"object","properties":{"ping":{"type":"string"}}},"VerificationId":{"type":"object","properties":{"verificationId":{"type":"string","writeOnly":true},"value":{"type":"string","format":"uuid","minLength":1}},"required":["value"]},"VerificationResponse":{"type":"object","properties":{"status":{"type":"string","enum":["PENDING","ACTIVE","PRESENTED","FAILED"],"example":"PRESENTED"},"presentation":{"type":"string","example":"<jwt>"}}}}}}