API 토큰 | Procurize.AI#

Procurize.AI 워크스페이스에 대한 안전한 프로그래밍 접근을 위해 API 토큰을 생성, 관리 및 사용하세요.

적용 대상: Procurize.AI 대시보드 → 설정 → 토큰
제공 플랜: 비즈니스 & 엔터프라이즈 플랜
필수 역할: 보안 관리자, 편집자, 관리자 또는 유지관리자

개요#

API 토큰은 Procurize.AI 플랫폼에 대한 안전한 프로그래밍 접근을 가능하게 합니다. 토큰을 사용해 Procurize.AI를 내부 시스템과 통합하거나, 워크플로를 자동화하거나, 플랫폼 위에 맞춤형 애플리케이션을 구축할 수 있습니다.

핵심 특성:

• 토큰은 생성한 사용자의 전체 권한을 상속합니다
• 토큰은 조직 범위이며 API 호출 시 org를 지정할 필요가 없습니다
• 무제한 토큰을 생성할 수 있습니다
• 토큰은 만료일을 가질 수 있거나 무기한으로 설정할 수 있습니다
• 필요에 따라 토큰을 비활성화하고 나중에 재활성화할 수 있습니다

🔒 보안 참고: Procurize.AI는 토큰 값을 저장하지 않으며 해시만 보관합니다. 생성 직후 토큰을 복사하여 안전하게 보관해야 합니다. 이후에는 다시 표시되지 않습니다.

토큰 관리 패널 접근#

1. 대시보드 → API 토큰 페이지로 이동합니다.
2. 토큰 관리 패널에 현재 조직에 연결된 개인 토큰이 표시됩니다.

필요 권한: 보안 관리자, 편집자, 관리자 또는 유지관리자 역할을 가진 사용자만 이 패널에 접근할 수 있습니다. 자세한 역할 정의는 권한 개요 를 참고하세요.

새 토큰 생성#

1. 토큰의 목적을 식별하기 위해 이름을 입력합니다.

2. 만료 기간을 선택합니다:

   • 1개월
   • 3개월
   • 1년
   • 무기한 (제한 없는 유효 기간)

3. “생성” 버튼을 클릭합니다.

중요 – 토큰을 즉시 복사하세요#

생성 후 토큰 값은 한 번만 표시됩니다 – 즉시 복사하여 비밀번호 관리자나 환경 변수 등에 안전하게 저장하세요.

⚠️ 다시 토큰 값을 확인할 수 없습니다. Procurize.AI는 검증을 위한 해시만 저장합니다. 토큰을 분실하면 즉시 폐기하고 새 토큰을 생성해야 합니다.

기존 토큰 관리#

토큰 패널에는 생성된 모든 토큰이 다음 정보와 함께 목록으로 표시됩니다:

• 이름
• 접미사
• 생성 날짜
• 만료 날짜 (또는 “-”)
• 상태: 활성 또는 비활성

토큰 비활성화 / 재활성화#

• 비활성화 – 토큰을 일시적으로 사용 중지합니다. 필요 시 나중에 재활성화할 수 있습니다.
• 재활성화 – 이전에 비활성화된 토큰을 다시 활성 상태로 복구합니다.

💡 비활성화는 토큰을 삭제하지 않고 통합을 일시 중단할 때 유용합니다.

토큰 폐기#

• 폐기 – 토큰을 영구 삭제합니다. 이 작업은 되돌릴 수 없습니다.
• 토큰을 분실한 경우 즉시 폐기하고 새 토큰을 생성하세요.

API 토큰 사용#

기본 URL 및 인증#

예시 요청 (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"

🧠 조직 ID가 필요하지 않음 – 토큰이 조직에 바인딩되어 있어 API가 자동으로 컨텍스트를 해석합니다.

중요한 보안 및 사용 규칙#

문제 해결#

관련 주제#

• 권한 개요 – 상세 역할 정의
• 가격 플랜 – 어떤 플랜에 API 접근이 포함되는지
• REST API 레퍼런스 – 상세 엔드포인트 문서