미디어위키 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에서 가져옵니다

이 변수는 필수입니다.