이것은 $1 형식의 HTML 표현입니다. HTML은 디버깅에 적합하지만 응용 프로그램 사용에는 적합하지 않습니다.
출력 형식을 변경하려면 <var>format</var> 매개변수를 지정하십시오. $1 형식의 비 HTML 표현을 보려면 <kbd>format=$2</kbd>를 설정하십시오.
자세한 내용은 [[mw:Special:MyLanguage/API|전체 문서]] 또는 [[Special:ApiHelp/main|API 도움말]]을 참조하십시오.
이것은 $1 형식의 HTML 표현입니다. HTML은 디버깅에 적합하지만 응용 프로그램 사용에는 적합하지 않습니다.
출력 형식을 변경하려면 <var>format</var> 매개변수를 지정하십시오. $1 형식의 비 HTML 표현을 보려면 [$3 <kbd>format=$2</kbd>]를 설정하십시오.
자세한 내용은 [[mw:API|전체 문서]] 또는 [[Special:ApiHelp/main|API 도움말]]을 참조하십시오.
This is an HTML representation intended for debugging, and is unsuitable for application use.
See the [[mw:Special:MyLanguage/API|complete documentation]], or the [[Special:ApiHelp/main|API help]] for more information.
이 모듈을 사용하는 일반적인 절차는 다음과 같습니다:
# <kbd>amirequestsfor=$4</kbd>와 함께 <kbd>[[Special:ApiHelp/query+authmanagerinfo|action=query&meta=authmanagerinfo]]</kbd>에서 사용할 수 있는 필드와 <kbd>[[Special:ApiHelp/query+tokens|action=query&meta=tokens]]</kbd>의 토큰을 가져옵니다.
# 사용자에게 필드를 제시하고 사용자의 제출 사항을 취득합니다.
# <var>$1returnurl</var> 및 관련된 모든 필드를 제공, 이 모듈에 전달합니다.
# 응답 시 <samp>status</samp>를 확인합니다.
#* <samp>PASS</samp> 또는 <samp>FAIL</samp>을 수신한 경우 작업은 끝난 것입니다. 동작은 성공하였거나 그렇지 않은 경우입니다.
#* <samp>UI</samp>를 수신한 경우 사용자에게 새로운 필드를 제시하고 사용자의 제출 사항을 취득합니다. 그 뒤 <var>$1continue</var> 및 관련된 모든 필드 집합과 함께 이 모듈에 전달하고 단계 4를 반복합니다.
#* <samp>REDIRECT</samp>를 수신한 경우, 사용자를 <samp>redirecttarget</samp>으로 넘겨준 다음 <var>$1returnurl</var>로 반환될 때까지 기다립니다. 그 뒤 <var>$1continue</var> 및 반환 URL에 전달되는, 모든 관련 필드와 함께 이 모듈에 전달하고 단계 4를 반복합니다.
#* <samp>RESTART</samp>를 수실한 경우 인증은 동작했으나 연결된 사용자 계정이 없다는 것을 의미합니다. <samp>UI</samp>나 <samp>FAIL</samp>로 간주할 수 있습니다.
이 모듈은 사용 가능한 인증 요청에 따라 추가 변수를 허용합니다. 사용 가능한 요청 및 사용되는 필드를 결정하려면 <kbd>amirequestsfor=$1</kbd>(또는 해당되는 경우 이 모듈의 과거 응답)과 함께 <kbd>[[Special:ApiHelp/query+authmanagerinfo|action=query&meta=authmanagerinfo]]</kbd>을(를) 사용하십시오.
<kbd>amirequestsfor=$1</kbd>을(를) 지정하여 <kbd>[[Special:ApiHelp/query+authmanagerinfo|action=query&meta=authmanagerinfo]]</kbd>가 반환한 <samp>id</samp>를 통해 이 인증 요청을 사용합니다.
<kbd>amirequestsfor=$1</kbd>와(과) 함께 <kbd>[[Special:ApiHelp/query+authmanagerinfo|action=query&meta=authmanagerinfo]]</kbd>에서 반환된 <samp>id</samp>를 통해, 또는 이 모듈의 과거 응답으로부터 이 인증 요청만을 사용합니다.
서드파티 인증 플로의 URL을 반환하며, 절대 주소여야 합니다. 이것 또는 <var>$1continue</var>는 필수입니다.
<samp>REDIRECT</samp> 응답을 받으면 일반적으로 서드파티 인증 플로를 위해 지정한 <samp>redirecttarget</samp> URL에 대해 브라우저나 웹 뷰를 열게 됩니다. 이 작업이 끝나면 서드파티는 브라우저나 웹 뷰를 이 URL로 보냅니다. URL로부터 쿼리나 POST 변수를 추출한 다음 이것들을 <var>$1continue</var> 요청으로서 이 API 모듈로 전달하는 것이 좋습니다.
만기 값은 상대값(예: <kbd>5 months</kbd> 또는 <kbd>2 weeks</kbd>) 또는 절대값(예: <kbd>2014-09-18T12:34:56Z</kbd>)입니다. 만기 값이 없는 경우 <kbd>infinite</kbd>, <kbd>indefinite</kbd>, <kbd>infinity</kbd> 또는 <kbd>never</kbd>를 사용합니다.
타임스탬프는 여러 형식으로 지정할 수 있습니다. 자세한 사항은 [[mw:Special:MyLanguage/Timestamp|mediawiki.org에 문서화된 타임스탬프 라이브러리 입력 포맷]]을 참고하십시오. ISO 8601 날짜 및 시간이 권장됩니다: <kbd><var>2001</var>-<var>01</var>-<var>15</var>T<var>14</var>:<var>56</var>:<var>00</var>Z</kbd>. 또, 문자열 <kbd>now</kbd>를 사용하여 현재 타임스탬프를 지정할 수 있습니다.
미디어위키의 입력은 NFC 정규화 UTF-8인 것이 좋습니다. 미디어위키는 다른 입력의 변환을 시도할 수 있지만 일부 동작(MD5 검사를 수반한 [[Special:ApiHelp/edit|편집]] 등)을 실패할 수 있습니다.
여러 값을 받는 변수는 보통 파이프 문자를 사용하여 구분되는 값으로 제출합니다. (예: <kbd>param=value1|value2</kbd> 또는 <kbd>param=value1%7Cvalue2</kbd>) 값에 파이프 문자가 포함되어야 하는 경우 U+001F(단위 구분자)를 구분자로, 값의 접두사를 U+001F로 사용하십시오. (예: <kbd>param=%1Fvalue1%1Fvalue2</kbd>)
API 요청의 일부 변수 유형은 추가 설명이 필요합니다: