본문으로 건너뛰기

pseudonymize.io API

pseudonymize.io 문서에 오신 것을 환영합니다. 민감한 데이터가 외부 시스템(예: LLM, 분석 웨어하우스 또는 타사 지원 도구)에 도달하기 전에 이 API를 해당 데이터의 경로에 배치하세요.

빠른 시작

산문을 가명화하기 위해 Text API에 요청을 보냅니다.

curl -X POST https://api.pseudonymize.io/text \
  -H "Authorization: Bearer ps_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Alice Rossi disputed invoice INV-204 from [email protected]",
    "policy": "default"
  }'

응답:

{
  "text": "PERSON_01 disputed invoice INV-204 from EMAIL_01",
  "entities": [
    { "type": "PERSON", "original": "Alice Rossi", "pseudonym": "PERSON_01" },
    { "type": "EMAIL", "original": "[email protected]", "pseudonym": "EMAIL_01" }
  ]
}

인증

모든 API 요청에는 Authorization 헤더에 API 키가 포함되어야 합니다.

Authorization: Bearer ps_live_...

API 키는 'ps_live_...' 형식으로 생성됩니다. 보안을 위해 전체 비밀 키는 생성 시 한 번만 표시됩니다. pseudonymize.io는 API 키를 일반 텍스트로 저장하지 않습니다. 되돌릴 수 없는 암호화 해시(SHA-256)와 짧은 식별 접두사(ps_live_XXXX)만 유지됩니다.

대시보드에서 API 키를 관리할 수 있습니다.

텍스트 API

POST https://api.pseudonymize.io/text(POST https://api.pseudonymize.io/v1/text 및 /api/v1/text를 통해서도 사용 가능)

주변 텍스트를 병합하지 않고 산문 내부의 식별자를 대체합니다.

요청 본문

  • text(문자열, 필수): 처리할 텍스트입니다.
  • policy(문자열, 선택사항): 사용할 정책입니다. 기본값은 "기본값"입니다.
  • Detect(배열, 선택 사항): 감지할 특정 엔터티 유형입니다.
{
  "text": "Call me at +39 333 1234567.",
  "detect": ["PHONE"]
}

구조화된 데이터 API

POST /api/v1/data

행과 스키마를 사용 가능한 상태로 유지하면서 식별자 필드를 가명화합니다.

요청 본문

  • 페이로드(객체 | 배열, 필수): 처리할 JSON 구조(데이터로 전달될 수도 있음).
  • policy(문자열, 선택사항): 사용할 정책입니다. 기본값은 "기본값"입니다.
  • Detect(배열, 선택 사항): 감지할 특정 엔터티 유형입니다.
{
  "payload": {
    "user": {
      "name": "Mario Rossi",
      "email": "[email protected]"
    }
  },
  "detect": ["PERSON", "EMAIL"]
}

빌링 & 크레딧 예약

Pseudonymize.io는 투명한 종량제 모델로 운영됩니다.

  • 측정 토큰 100만 개당 €1입니다. 성공한 요청마다 1,000토큰(1크레딧) 단위로 올림하며 최소 요금은 €0.001입니다.
  • 비행 전 예약: 페이로드가 코어 엔진에 도달하기 전에 게이트웨이 경계에서 크레딧이 원자적으로 예약됩니다. 계정에 크레딧이 부족한 경우 API는 고객 데이터를 전달하지 않고 즉시 '402 결제 필요'를 반환합니다.
  • 자동 환불 보장: 업스트림 코어 처리 호출이 실패하거나 시간 초과되면 예약된 크레딧이 즉시 전액 환불됩니다.

가명 및 확정적 신원

Pseudonymize.io는 단일 요청 내에서 결정적 신원 보존을 사용합니다. 동일한 문서에 "Alice"가 세 번 나타나면 그녀는 세 번 모두 'PERSON_01'이 됩니다. 이를 통해 LLM은 누구인지 알지 못해도 동일 사람임을 이해할 수 있습니다.

오류 및 한계

우리는 표준 HTTP 상태 코드를 사용합니다.

  • 200 OK: 성공적으로 처리되었습니다.
  • 400 Bad Request: 페이로드 형식이 잘못되었거나 누락되었거나, 구조화된 데이터 깊이가 32레벨을 초과합니다.
  • 401 Unauthorized: API 키가 없거나 잘못되었거나 비활성 상태입니다.
  • '402 결제 필요': 남은 크레딧이 부족합니다. 게이트웨이 경계에서 차단되었습니다.
  • '413 페이로드가 너무 큼': 요청 본문이 10MB를 초과하거나 구조화된 총 요소 수가 50,000개 키를 초과합니다.
  • '429 요청이 너무 많음': 속도 제한이 초과되었습니다(API 키당 60req/min, 계정 및 IP당 120req/min). 'Retry-After' 헤더는 재시도 시기를 나타냅니다.
  • 502 잘못된 게이트웨이: 코어 엔진에 연결할 수 없거나 백엔드 처리 실패. 크레딧은 자동으로 환불됩니다.
  • '504 Gateway Timeout': 코어 엔진이 30초 이내에 응답하지 않았습니다. 크레딧은 자동으로 환불됩니다.

지원되는 엔터티

  • PERSON(이름)
  • ORGANIZATION(회사 이름)
  • EMAIL(이메일 주소)
  • PHONE(전화번호)
  • LOCATION(도시, 주소)
  • IP(IPv4 및 IPv6)
  • IBAN(은행계좌)
  • CARD(신용/직불카드)

보안

  • 게이트웨이 청구 테이블 및 구조화된 요청 지표에는 API 요청 및 응답 본문이 제외됩니다. 계정, 인증, 사용, 예약 및 결제 메타데이터는 별도로 보관됩니다. 계정을 삭제해도 모든 기록이나 백업이 삭제되는 것은 아닙니다.
  • Idempotency-Key를 사용한 성공적인 응답은 5분 재생 기간 동안 프로세스 메모리에 유지됩니다. 엔터티 세부정보에는 원래 식별자가 포함될 수 있습니다. 엔진, 프록시, 스왑, 크래시 덤프 및 백업 제어에는 별도의 검증이 필요합니다. 처리 체인 전반에 걸쳐 제로 디스크 지속성이 보장되지 않습니다.
  • 처리 및 삭제 제한에 대해서는 개인정보 보호정책 및 보안 페이지를 참조하세요.