파일 관리

파일 주소 가져오기 API를 사용하여 얻은 fileUpload URL을 사용한 후, 획득한 URL을 사용하여 HTTP PUT 방식으로 파일 스트림을 업로드했는지 확인하십시오. 업로드하지 않은 경우 URL을 호출하여 파일을 업로드하십시오.

파일 업로드 주소의 유효 기간은 얼마나 됩니까?

파일 업로드 주소, 링크접속 유효 기간은 60분입니다.

연동 과정 중 파일 업로드 사이트https://file-sml.esignglobal.com/매우 느림, 파일 업로드 속도가 느림

샌드박스 환경 연동 시 파일 업로드에 유의해야 합니다. 서버가 싱가포르에 위치해 있어 국내에서 직접 접속할 경우 네트워크가 불안정하여 끊김, 로딩 지연 또는 접속 불가 등의 문제가 자주 발생합니다. 따라서 싱가포르 프록시를 통해 접속하는 것이 네트워크 불안정성을 개선하고 파일 서비스를 보다 편리하게 사용하는 데 도움이 됩니다.

openapi 호출로 파일 주소 가져오기 성공 후 파일 업로드 실패

1단계: 파일 업로드 주소 가져오기 작업 과정에서 파일 업로드 주소를 가져오려면 다음과 같은 형식으로 관련 정보를 제공해야 합니다. { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } 여기서 파일 이름은 'fengniantest.pdf'이지만 콘텐츠 유형(contentType)은 'application/pdf'로 지정되어 있으므로 관련 매개변수가 정확한지 확인해야 합니다.

2단계: 파일 직접 전송 시 요청 헤더 정보 추가 파일 직접 업로드 작업을 수행할 때 요청 헤더(headers)에 'Content-Type: application/pdf' 정보를 추가하여 업로드할 파일 유형을 명확히 하고 파일 직접 전송 작업이 원활하게 진행되도록 해야 합니다.

OpenAPI 파일 업로드에서 지원하는 파일 형식은 무엇입니까?

다음과 같은 형식의 파일을 지원합니다. PDF(.pdf), Word(.docx, .doc), RTF(.rtf), Excel(.xlsx, .xls), PowerPoint(.pptx, .ppt), WPS 문자(.wps), WPS 스프레드시트(.et), WPS 프레젠테이션(.dps), JPEG(.jpeg, .jpg), PNG(.png), BMP(.bmp), TIFF(.tiff), GIF(.gif), HTML(.html, .htm) 및 CSV(.csv) 형식입니다.

taskId를 통해 파일 합성 작업을 조회할 때 '파일 변환 실패: 네트워크 주소 액세스 실패' 오류가 발생합니다.

문서 변환 시간이 초과되면 파일 합성에 실패하는 경우가 많습니다. 이 경우 템플릿을 다시 호출하여 파일을 생성한 다음 파일 합성 작업 조회 인터페이스를 호출하여 이번 파일 합성이 성공했는지 확인하십시오. 위의 작업을 수행한 후에도 파일 합성이 계속 실패하면 기술 담당자에게 직접 문의하여 전문 기술 담당자의 도움을 받아 이 문제를 해결할 수 있습니다.

파일 업로드 주소 가져오기 및 파일 직접 전송 매개변수 호출이 모두 정확하지만 파일 직접 전송 시 여전히 "403 Forbidden: "<?xml version="1.0" encoding="UTF-8"?><EOL><Error><EOL> <Code>SignatureDoesNotMatch</Code><EOL> <Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message><EOL> <RequestId>68440537821143343409E1E9</RequestId><EOL>" 오류가 발생합니다.

1단계에서 전달된 매개변수가contentType2단계 헤더에서 전송된 내용과Content-Type일치하고 Postman을 통해 호출fileUploadUrl직접 파일 전송에 성공했지만 코드 호출 시 여전히 오류가 발생합니다. 중단점을 통해 매개변수 전달에 오류가 없는지 확인한 결과 프레임워크 애플리케이션에 호환성 문제가 있는 것 같습니다. 다음 코드 예제를 참조하여 파일을 직접 전송하는 것이 좋습니다.

참조 코드:

// 调用方式（以Java为例）
Response response = HttpUtil.sendRequest(
    "uploadUrl",                // 上传接口URL
    new File("文件路径/xxx.pdf"), // 待上传文件
    "application/pdf",          // 内容类型
    new HashMap<>()             // 可选请求头参数（若无则传空）
);

핵심 설명:

매개변수 일관성 검증: 코드에서Content-Type매개변수(예:"application/pdf")가 인터페이스 요구 사항과 대소문자 및 형식(예:application/json)을 포함하여 완전히 일치하는지 확인합니다.application/JSON와 엄격히 구분해야 함).
프레임워크 호환성 문제 해결: 코드 논리에 오류가 없지만 여전히 오류가 발생하면 고객 프레임워크를 우회하고 기본 HTTP 클라이언트(예: Java의URLConnection, Python의requests)를 사용하여 요청 헤더, 파일 스트림 처리의 프레임워크 호환성 문제인지 확인합니다.
오류 로그 위치 지정: 고객이 전체 오류 정보(예: HTTP 상태 코드, 서버 반환 메시지)를 캡처하고 기록하여 네트워크 계층 또는 서버 측의 특정 오류 원인을 추가로 조사하는 것이 좋습니다.

이 솔루션은 표준화된 매개변수 전달 및 간소화된 호출 링크를 통해 프레임워크 문제를 효과적으로 격리하고 파일 직접 전송 실패의 근본 원인을 신속하게 찾을 수 있습니다.