미디어위키 API 도움말
이 페이지는 자동으로 생성된 미디어위키 Action API 설명문서입니다.
action=edit
- 이 모듈은 read 권한을 요구합니다.
- 이 모듈은 write 권한을 요구합니다.
- 이 모듈은 POST 요청만을 허용합니다.
- 출처: MediaWiki
- 라이선스: GPL-2.0-or-later
문서를 만들고 편집합니다.
- title
편집할 문서의 제목. pageid과 같이 사용할 수 없습니다.
- pageid
편집할 문서의 문서 ID입니다. title과 함께 사용할 수 없습니다.
- 유형: 정수
- section
문단 식별자입니다. 0은 최상위 문단, new는 새 문단입니다. 종종 양의 정수이지만 숫자가 아닐 수도 있습니다.
- sectiontitle
section=new를 사용할 때 새 문단을 위한 제목입니다.
- text
문서 내용.
- summary
편집 요약입니다.
이 매개변수가 제공되지 않거나 비어 있으면 편집 요약이 자동으로 생성될 수 있습니다.
section=new를 사용하는 경우 sectiontitle이 제공되지 않은 경우 이 매개변수의 값이 대신 문단 제목에 사용되며 편집 요약이 자동으로 생성됩니다.
이 판에 적용할 변경 태그입니다.
- 값 (|로 구분): 또는 다른 문자열:
- minor
이 편집을 사소한 편집으로 표시합니다.
- 유형: 불리언 (자세한 정보)
- notminor
"모든 편집에 기본적으로 사소한 편집을 표시" 사용자 환경 설정이 설정된 경우에도 이 편집을 사소한 편집으로 표시하지 않습니다.
- 유형: 불리언 (자세한 정보)
- bot
이 편집을 봇 편집으로 표시.
- 유형: 불리언 (자세한 정보)
- baserevid
기본 판의 타임스탬프이며, 편집 충돌을 발견하기 위해 사용됩니다. action=query&prop=revisions를 통해 가져올 수 있습니다. basetimestamp을 설정하지 않으면 자체 충돌 시 편집 실패가 발생합니다.
- 유형: 정수
- basetimestamp
기본 판의 타임스탬프이며, 편집 충돌을 발견하기 위해 사용됩니다. action=query&prop=revisions&rvprop=timestamp를 통해 가져올 수 있습니다. 자신의 충돌은 무시됩니다.
- 유형: 타임스탬프 (허용되는 포맷)
- starttimestamp
편집 과정을 시작할 때의 타임스탬프이며 편집 충돌을 발견하기 위해 사용됩니다. 편집 과정을 시작할 때(예: 문서 내용을 편집으로 불러올 때) curtimestamp를 사용하여 적절한 값을 가져올 수 있습니다.
- 유형: 타임스탬프 (허용되는 포맷)
- recreate
중간에 삭제되는 문서에 관한 오류를 모두 무시합니다.
- 유형: 불리언 (자세한 정보)
- createonly
이 페이지가 이미 존재하면 편집하지 않습니다.
- 유형: 불리언 (자세한 정보)
- nocreate
페이지가 존재하지 않으면 오류를 출력합니다.
- 유형: 불리언 (자세한 정보)
- watch
- 구식입니다.
문서를 현재 사용자의 주시문서 목록에 추가합니다.
- 유형: 불리언 (자세한 정보)
- unwatch
- 구식입니다.
문서를 현재 사용자의 주시문서 목록에서 제거합니다.
- 유형: 불리언 (자세한 정보)
- watchlist
현재 사용자의 주시목록에서 문서를 무조건적으로 추가하거나 제거하거나, 환경 설정을 사용하거나 (봇 사용자는 무시됨) 주시를 변경하지 않습니다.
- 다음 값 중 하나: nochange, preferences, unwatch, watch 또는 다른 문자열: nochange, preferences, unwatch, watch
- 기본값: preferences
- md5
text 매개변수의 MD5 해시값 또는 prependtext과 appendtext 매개변수를 이어붙인 값입니다. 이 값이 설정된 경우, 해시값이 올바르지 않으면 편집이 되지 않습니다.
- prependtext
이 텍스트를 문서 또는 문단의 처음에 추가합니다. text를 무효로 합니다.
- appendtext
이 텍스트를 문서 또는 문단의 끝에 추가합니다. text를 무효로 합니다.
새 문단을 추가하려면 이 매개변수 대신 section=new를 사용하십시오.
- undo
이 판의 편집을 취소합니다. text, prependtext, appendtext를 무효로 합니다.
- 유형: 정수
- 값은 0 이상이어야 합니다.
- undoafter
undo에서부터 이 판까지의 모든 수정사항을 취소합니다. 설정하지 않으면 하나의 수정사항만 취소합니다.
- 유형: 정수
- 값은 0 이상이어야 합니다.
- redirect
자동으로 넘겨주기를 처리합니다.
- 유형: 불리언 (자세한 정보)
- contentformat
입력 텍스트에 사용할 내용 직렬화 포맷입니다.
- 다음 값 중 하나: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown 또는 다른 문자열: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
새 콘텐츠의 콘텐츠 모델.
- 다음 값 중 하나: Scribunto, css, javascript, json, sanitized-css, text, unknown, vue, wikitext 또는 다른 문자열: Scribunto, css, javascript, json, sanitized-css, text, unknown, vue, wikitext
- token
"csrf" 토큰은 action=query&meta=tokens에서 가져옵니다
토큰은 무조건 마지막 매개변수로 보내거나 적어도 text 매개변수 뒤에 보내는 것이 좋습니다.
- 이 매개변수는 필수입니다.
- returnto
문서 제목입니다. 편집 내용을 저장하는 과정에서 임시 계정이 생성된 경우, API는 클라이언트가 로그인을 완료하기 위해 방문해야 할 URL을 응답으로 반환할 수 있습니다. 이 매개변수가 제공되면, 해당 URL은 편집된 페이지 대신 주어진 페이지로 넘겨주기합니다.
- 유형: 문서 제목
- 존재하지 않는 문서를 허용합니다.
- returntoquery
URL 쿼리 매개변수입니다 (앞에 ?가 붙은 형태). 편집 내용을 저장하는 과정에서 임시 계정이 생성된 경우, API는 클라이언트가 로그인을 완료하기 위해 방문해야 할 URL을 응답으로 반환할 수 있습니다. 이 매개변수가 제공되면, 해당 URL은 주어진 쿼리 매개변수가 포함된 페이지로 넘겨주기됩니다.
- 기본값: (비어 있음)
- returntoanchor
URL 프래그먼트입니다 (앞에 #가 붙은 형태). 편집 내용을 저장하는 과정에서 임시 계정이 생성된 경우, API는 클라이언트가 로그인을 완료하기 위해 방문해야 할 URL을 응답으로 반환할 수 있습니다. 이 매개변수가 제공되면, 해당 URL은 지정된 프래그먼트가 포함된 페이지로 넘겨주기 됩니다.
- 기본값: (비어 있음)
- 문서 편집
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [연습장에서 열기]
- 문서의 맨 앞에 __NOTOC__를 추가합니다.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [연습장에서 열기]
- 자동 편집요약으로 13579에서 13585까지의 수정사항을 되돌립니다.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [연습장에서 열기]