파일 업로드 URL
매뉴얼웍스가 사용하는 파일 업로드 URL은 다음과 같습니다.
매뉴얼웍스 6.0.4 버전을 기준으로 합니다. 메이저 또는 마이너 릴리스에서 새로운 URL이 추가되거나 기존 URL이 삭제될 수 있습니다.
URL | 설명 |
|---|---|
/r/abbreviation_term/upload_excel | 약어집 엑셀 파일로 올리기 |
/r/answer/upload_file/${id} | <태스크> 메뉴에서 답변에 첨부 파일 올리기 |
/r/create_chapter_from_markdown/upload/${id} | 문서의 장 목록에 마크다운 파일을 끌어다 놓아 장으로 만들기 |
/r/editor_print_image/upload/${id} | 에디터에서 인쇄용 그림 올리기 |
/r/font/upload | <서식 | PDF 글꼴> 메뉴에서 글꼴 파일 올리기 |
/r/file/upload | 공통 기능으로 파일 올리기 |
/r/file_explorer/change_file/${id} | <리소스 | 파일> 메뉴에서 파일 바꾸기 |
/r/file_explorer/upload | <리소스 | 파일> 메뉴에서 파일 올리기 |
/r/glossary/upload_terms | <리소스 | 용어집> 메뉴에서 용어 파일 가져오기 |
/r/hyphenation_pattern/upload/${locale} | <리소스 | 하이픈 패턴> 메뉴에서 하이픈 패턴 파일 올리기 |
/r/image_explorer/upload | <리소스 | 그림> 메뉴에서 그림 파일 올리기 |
/r/import_from_file/upload/${id} | 워드 파일 올려 장으로 만들기 |
/r/inline_image_explorer/upload | <리소스 | 단락 안 그림> 메뉴에서 그림 파일 올리기 |
/r/newsletter_subscriber/upload_subscribers | <도구 | 뉴스레터 구독자> 메뉴에서 구독자 파일 가져오기 |
/r/software_update/upload | 매뉴얼웍스 업데이트 서버에 연결이 되지 않을 때 소프트웨어 업데이트를 위한 파일 업로드 |
/r/static/upload/${id} | 정적 문서에서 파일 올리기 |
/r/task/upload_file/${id} | <태스크> 메뉴에서 첨부 파일 올리기 |
파일 업로드 처리
매뉴얼웍스는 웹 브라우저에서 선택한 파일을 XMLHttpRequest로 서버에 그대로 전송합니다.
그리고 매뉴얼웍스는 XMLHttpRequest를 파일 업로드할 때만 사용합니다. 다른 작업은 Fetch API를 사용합니다. 따라서 네트워크 단에서 XMLHttpRequest를 이용한 요청은 파일 업로드 작업으로 분류할 수 있습니다. 단, 다음은 XMLHttpRequest를 사용하지 않고 파일 내용을 서버에 보내므로 XMLHttpRequest 요청만으로 모든 파일 업로드를 가려낼 수는 없습니다.
에디터에 클립보드의 그림을 붙여 넣을 때: Fetch API로 그림 데이터(base64)를
/r/clipboard에 보냅니다.에디터에 마크다운 파일을 올릴 때: Fetch API로 파일 내용을
/r/upload_markdown/upload/${id}에 보냅니다.태스크와 답변 편집기에 그림을 넣거나 붙여 넣을 때: 그림 데이터를 본문에 담아 저장 요청과 함께 보냅니다.
MCP 클라이언트가 그림을 올릴 때: 웹 브라우저를 거치지 않고
/r/mcp_upload에 보냅니다.
단 매뉴얼웍스가 사용하는 오픈소스 라이브러리 Monaco Editor에서는 XMLHttpRequest를 사용할 수 있습니다. 경로는 /resource/monaco_editor/입니다.