NAVER WORKS

안녕하세요.

네이버웍스 전자결재(외부문서) API 연동 중 파일 첨부(upload) 관련하여 문의드립니다.

현재 진행 중인 흐름은 아래와 같습니다.

1. OAuth 인증을 통해 access_token 발급

2. 전자결재 문서 생성 API 호출 시 첨부파일 등록을 위한 사전 요청 수행

3. 응답으로 uploadUrl 및 fileId 수신

4. 해당 uploadUrl로 multipart/form-data 방식 파일 업로드 수행

5. fileId를 documentBody(CP_ATTACH_FILE)에 포함하여 create-document-link 호출

■ 문의 사항

1. uploadUrl로 파일 업로드 시 Authorization 헤더 사용 여부
   현재 아래와 같이 Authorization 헤더를 포함하여 요청 시 오류가 발생합니다.

• Authorization: Bearer {access_token}

• 응답:

{
  "code": "UNAUTHORIZED",
  "description": "Malformed authentication token"
}

→ uploadUrl 호출 시 Authorization 헤더를 제거하면 정상 동작해야 하는지 확인 부탁드립니다.

1. uploadUrl 요청 시 사용해야 하는 토큰 종류

• OAuth access_token을 사용해야 하는지

• 또는 uploadUrl 발급 시 별도의 upload 전용 토큰이 존재하는지

• 혹은 uploadUrl 자체에 인증 정보가 포함된 pre-signed URL 형태인지

정확한 인증 방식 확인 부탁드립니다.

1. 파일 업로드 성공 기준
   파일 업로드 성공 시 응답으로 fileId가 반환되는 것으로 이해하고 있습니다.

• upload 응답 body에 fileId가 반드시 포함되어야 하는지

• 또는 uploadUrl 발급 시 받은 fileId를 그대로 사용하는 구조인지 확인 부탁드립니다.

1. 첨부파일 component 구조 관련
   전자결재 문서 생성 시 첨부파일 component 구성은 아래와 같이 사용 중입니다.

{
  "componentType": "CP_ATTACH_FILE",
  "componentId": "{componentId}",
  "componentValue": {
    "fileItems": [
      {
        "fileId": "{fileId}"
      }
    ]
  }
}

→ 위 구조가 올바른지, 또는 attachments 등 다른 필드명을 사용해야 하는지 확인 부탁드립니다.

현재 상황은

• upload API 호출 시 401 Unauthorized 또는 Malformed authentication token 발생

• 또는 문서 생성은 정상이나 첨부파일이 화면에 표시되지 않는 상태입니다.

관련하여 정확한 업로드 방식 및 인증 처리 방법에 대해 가이드 부탁드립니다.

감사합니다.