발급기관 온보딩

POST/public/issuer-onboarding/apply — 발급기관 신청

인증이 필요 없습니다. 누구나 호출할 수 있는 공개 접수 창구이며, 다른 공개 엔드포인트와 같은 속도 제한(60 req/min, 호출 IP 기준)이 적용됩니다.

요청

{
  "orgName": "국립○○대학교",
  "orgType": "UNIVERSITY",
  "countryCode": "KR",
  "contactEmail": "did-admin@univ.example.ac.kr",
  "requestedCredentialTypes": ["StudentCard", "CompletionCertificate"],
  "purposeNote": "재학생 학생증과 수료증을 디지털 증명서로 발급하려 합니다."
}

응답 200

{
  "success": true,
  "data": { "id": 41 },
  "message": "Issuer onboarding application received"
}

id는 접수번호입니다. 심사 결과는 contactEmail로 연락드리며, 승인 시 clientId와 API 키를 함께 전달합니다.

필드

검증 실패: SW1001(HTTP 400). 형식·길이·개수 위반, 중복, 이메일 형식 오류가 모두 여기에 해당합니다.

POST/issuer/credentials/issue — 기관 명의로 증명서 발급

요청

{
  "holderDid": "did:sw:0x8f2a41c9d27b6e5a1c0f3d94ab77e5c621d0a4b3",
  "credentialType": "StudentCard",
  "claims": {
    "studentNo": "2026-000412",
    "faculty": "Computer Engineering",
    "enrollmentStatus": "ENROLLED"
  },
  "validityDays": 365
}

응답 200

{
  "success": true,
  "data": { "credentialId": 10427 },
  "message": "Credential issued"
}

credentialId는 발급된 증명서의 식별자입니다. 발급이 성공하면 사용자의 지갑에서 해당 증명서를 볼 수 있습니다.

주의: 이 API에는 멱등키가 없습니다. 같은 요청을 두 번 보내면 증명서가 두 건 발급됩니다. 네트워크 오류로 응답을 받지 못했다면, 재시도 전에 GET /issuer/credentials로 이미 발급되었는지 확인하세요.

GET/issuer/credentials?page=0 — 우리 기관이 발급한 목록

기관 명의로 발급된 증명서만 조회합니다(다른 기관 발급분은 보이지 않습니다). 페이지 크기는 20건 고정이며, page는 0부터 시작합니다(음수는 SW1001).

응답 200

{
  "success": true,
  "data": {
    "page": 0,
    "size": 20,
    "totalElements": 137,
    "totalPages": 7,
    "content": [
      {
        "credentialId": 10427,
        "credentialUid": "vc_9f2ab1c4e5d6",
        "holderDid": "did:sw:0x8f2a41c9d27b6e5a1c0f3d94ab77e5c621d0a4b3",
        "credentialType": "StudentCard",
        "status": "ACTIVE",
        "issuedAt": "2026-08-26T10:00:00",
        "expiresAt": "2027-08-26T10:00:00"
      }
    ]
  },
  "message": "Issuer credentials retrieved"
}

GET/issuer/whoami — 기관 정보와 발급 가능 종류

발급자 DID 등재가 끝났는지 확인하는 용도로도 씁니다. 이 엔드포인트는 등재 전에도 호출할 수 있습니다 (issuerDid가 null로 나옵니다).

응답 200

{
  "success": true,
  "data": {
    "applicationId": 41,
    "clientId": "pc_7d1e4a9b",
    "orgName": "국립○○대학교",
    "orgType": "UNIVERSITY",
    "countryCode": "KR",
    "contactEmail": "did-admin@univ.example.ac.kr",
    "issuerDid": "did:sw:0x3c7b21e8a4d05f9b6c1e7a2d8f4b03c95e6a1d72",
    "status": "APPROVED",
    "credentialTypes": ["StudentCard", "CompletionCertificate"]
  },
  "message": "Issuer information retrieved"
}

credentialTypes가 발급 가능한 종류의 전부입니다 — 여기에 없는 값으로는 발급되지 않습니다.