미디어위키 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를 사용하여)

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Upload

변수:

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에서 가져옵니다; 이 변수는 필수 입력 사항입니다.

예시:

URL에서 업로드합니다.: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [연습장에서 열기]
경고로 인해 실패한 업로드를 마칩니다.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [연습장에서 열기]