미디어위키 API 도움말

이 페이지는 자동으로 생성된 미디어위키 API 도움말 문서입니다.

설명 문서 및 예시: https://www.mediawiki.org/wiki/API

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

업로드 기록 항목과 파일 문서 판에 적용할 태그를 변경합니다.

값 (|로 구분): 또는 alternative:
text

새로운 파일들에 대한 초기 문서 텍스트.

watch
구식입니다.

문서를 주시합니다.

유형: 불리언 (자세한 정보)
watchlist

현재 사용자의 주시목록에서 문서를 무조건적으로 추가하거나 제거하거나, 환경 설정을 사용하거나 주시를 변경하지 않습니다.

다음 값 중 하나: watch, preferences, nochange 또는 alternative: watch, preferences, nochange
기본값: preferences
ignorewarnings

모든 경고를 무시합니다.

유형: 불리언 (자세한 정보)
file

파일의 내용입니다.

여러 부분/폼 데이터를 사용한 파일 업로드로 게시되어야 합니다.
url

파일을 가져올 URL입니다.

filekey

임시로 보관한 이전의 업로드를 식별하는 키입니다.

sessionkey
구식입니다.

filekey와 동일하며, 하위 호환성을 위해 유지됩니다.

stash

설정하면 서버는 저장소에 파일을 추가하는 대신 임시로 파일을 보관합니다.

유형: 불리언 (자세한 정보)
filesize

전체 업로드의 파일 크기입니다.

값은 0와 10,485,760 사이여야 합니다.
유형: 정수
offset

바이트 단위의 청크 오프셋.

값은 0 이상이어야 합니다.
유형: 정수
chunk

청크의 내용입니다.

여러 부분/폼 데이터를 사용한 파일 업로드로 게시되어야 합니다.
async

가능하면 잠재적으로 큰 파일 작업을 비동기로 처리합니다.

유형: 불리언 (자세한 정보)
checkstatus

제공된 파일 키의 업로드 상태만 가져옵니다.

유형: 불리언 (자세한 정보)
token

"csrf" 토큰은 action=query&meta=tokens에서 가져옵니다

이 변수는 필수 입력 사항입니다.