LinkOStar

지원

통합 중 막힘, 사양 명확화, 장애 발생 시 컨택. 가능한 빨리 답할 수 있도록 문의 유형별로 채널을 나누었습니다.

장애 / 운영 이슈 (production)

  • 증상: API 5xx · 응답 지연 · 인증 실패 · 데이터 누락 · 텔레메트리 수신 안됨 등.
  • 채널: LinkOStar 운영팀 슬랙 (#linkostar-ops). 시급 시 on-call 전화.
  • 알려주실 정보:
    • 발생 시각 (UTC) + 지속 시간
    • 실패한 endpoint + HTTP method
    • 응답 body의 traceId (있다면)
    • 요청한 tenant_uuid (시크릿이라 부분 masking 가능)
    • 본인 supplier 식별 (X-API-Key 자체는 보내지 마세요)
  • 응답 SLA: production 장애는 1시간 이내 1차 응답을 목표로 합니다.

통합 질의 / 사양 명확화

  • 증상: 문서에 없거나 모호한 동작 / 새 endpoint 필요 / 권장 패턴 확인.
  • 채널: GitHub Issue (해당 repo) 또는 슬랙 (#linkostar-dev).
  • 응답 SLA: 영업일 기준 2일 이내.

Breaking change 영향 확인

  • 이 문서의 변경 이력 페이지를 정기 확인.
  • 당신의 supplier가 LinkOStar 운영팀에 노티스 수신 컨택을 등록해 두세요 — slack 채널 또는 email DL.
  • OpenAPI spec diff를 CI에 걸어두면 breaking change가 본인 SDK 빌드에서 자동 잡힙니다.

보안 이슈

  • 키 유출, 인증 우회, 데이터 노출 의심 등은 공개 채널이 아닌 보안 직통으로 알려주세요.
  • 채널: security@linkostar.sandevaux.com (예시 — 실제 컨택은 발급된 자격증명 문서에 함께 전달됨).
  • PoC 가 있다면 첨부, 데이터셋 자체는 동봉하지 마세요 (요약만).

예시 컨택 가능 정보

Supplier에게 발급된 자격증명 핸드오프 문서에 다음이 함께 옵니다:

  • 본인 supplier 의 supplier_uuid / tenant_uuid
  • X-API-Key (production / 필요 시 staging)
  • 운영 컨택 슬랙 / email
  • 긴급 시 on-call 절차

이 정보는 LinkOStar의 외부 공개 문서(이 사이트)에 두지 않습니다 — 본인 조직의 secret manager에서 확인하세요.

본 문서 자체에 대한 피드백

용어 혼동, 잘못된 예시, 누락된 endpoint 발견 시 LinkOStar repo의 linkostar-web/src/app/[locale]/(public)/docs/ 디렉토리로 PR 환영합니다. 작은 수정도 좋습니다.