미디어위키 API 도움말
이 페이지는 자동으로 생성된 미디어위키 API 도움말 문서입니다.
설명 문서 및 예시: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=upload
(main | upload)
- 이 모듈은 read 권한을 요구합니다.
- 이 모듈은 write 권한을 요구합니다.
- 이 모듈은 POST 요청만을 허용합니다.
- 출처: MediaWiki
- 라이선스: GPL-2.0-or-later
파일을 업로드하거나 대기 중인 업로드의 상태를 가져옵니다.
몇 가지 방식을 사용할 수 있습니다:
- file 변수를 사용하여 파일의 내용을 직접 업로드합니다.
- filesize, chunk, offset 변수를 사용하여 파일을 부분적으로 업로드합니다.
- url 변수를 사용하여 미디어위키 서버가 URL로부터 파일을 가져오게 합니다.
- filekey 변수를 사용하여 경고로 실패한 과거의 업로드를 완료합니다.
file을(를) 보낼 때 HTTP POST는 파일 업로드로 끝나야 합니다. (예: multipart/form-data를 사용하여)
변수:
- filename
대상 파일 이름.
- comment
업로드 주석입니다. 또, text가 지정되지 않은 경우 새로운 파일들의 초기 페이지 텍스트로 사용됩니다.
- 기본값: (비어 있음)
- tags
업로드 기록 항목과 파일 문서 판에 적용할 태그를 변경합니다.
- 값 (|로 구분): 또는 다른 문자열:
- text
새로운 파일들에 대한 초기 문서 텍스트.
- watch
- 구식입니다.
문서를 주시합니다.
- Type: boolean (details)
- watchlist
현재 사용자의 주시목록에서 문서를 무조건적으로 추가하거나 제거하거나, 환경 설정을 사용하거나 (봇 사용자는 무시됨) 주시를 변경하지 않습니다.
- 다음 값 중 하나: nochange, preferences, watch 또는 다른 문자열: nochange, preferences, watch
- 기본값: preferences
- ignorewarnings
모든 경고를 무시합니다.
- Type: boolean (details)
- file
파일의 내용입니다.
- Must be posted as a file upload using multipart/form-data.
- url
파일을 가져올 URL입니다.
- filekey
임시로 보관한 이전의 업로드를 식별하는 키입니다.
- sessionkey
- 구식입니다.
filekey와 동일하며, 하위 호환성을 위해 유지됩니다.
- stash
설정하면 서버는 저장소에 파일을 추가하는 대신 임시로 파일을 보관합니다.
- Type: boolean (details)
- filesize
전체 업로드의 파일 크기입니다.
- Type: integer
- The value must be between 0 and 104,857,600.
- offset
바이트 단위의 청크 오프셋.
- Type: integer
- The value must be no less than 0.
- chunk
청크의 내용입니다.
- Must be posted as a file upload using multipart/form-data.
- async
가능하면 잠재적으로 큰 파일 작업을 비동기로 처리합니다.
- Type: boolean (details)
- checkstatus
제공된 파일 키의 업로드 상태만 가져옵니다.
- Type: boolean (details)
- token
"csrf" 토큰은 action=query&meta=tokens에서 가져옵니다
- 이 변수는 필수입니다.
![[연습장에서 열기]](/ko/index.php?title=%ED%8A%B9%EC%88%98:Api%EC%97%B0%EC%8A%B5%EC%9E%A5#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[연습장에서 열기]](/ko/index.php?title=%ED%8A%B9%EC%88%98:Api%EC%97%B0%EC%8A%B5%EC%9E%A5#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}