API Policy Update 2024/ko

Below is a new draft text of WMF legal policy discussing the use of its APIs. This new document is now published at Policy:API usage guidelines on the Foundation wiki.

A feedback period on it was open from August 28 to September 13, 2024, but comments are welcome on the talkpage.

맥락

2023년에, 광범위하고 세부적인 공개 협의 및 초안 작성 과정을 거친 후, 위키미디어 재단은 이용 약관(ToU)을 업데이트했습니다.

API를 참조하는 섹션에는 이제 다음과 같이 명시되어 있습니다:

12. API 약관:
저희는 사용자가 자유 지식을 촉진하는 제품을 개발할 수 있도록 돕기 위해 API 세트와 관련 문서 및 도구를 제공합니다. API를 사용함으로써, 귀하는 사용자-대리자 규정, 로봇 규정, API:에티켓를 포함한 API 사용을 규율하는 모든 관련 정책을 준수할 것에 동의하는 것입니다. 이 정책들(통칭하여 "API 문서")은 참조를 통해 본 이용 약관에 통합됩니다.

API는 항상 이용 약관의 적용을 받았지만, 해당 업데이트에서 위키미디어 재단은 (특히 악의적인 행위자에게) API가 이용 약관의 일부이며, 재단이 공정하고 신뢰할 수 있는 API 생태계의 일부인 규칙을 시행할 수 있는 능력을 가지고 있음을 명확히 하고자 했습니다.

이러한 노력을 계속하기 위해 재단은 재단이 API를 관리하는 방법을 설명하기 위해 API 문서를 업데이트하고 있습니다.

이것은 API 사용 요구 사항의 변경이 아닙니다. 이는 기존 관행을 더 자세히 설명하는 서술로, 재단이 허용 가능한 선의의 API 사용과 부적절하고 유해한 API 사용을 어떻게 구분하는지 설명하는 정보를 포함합니다. 이 업데이트는 개발자가 API와 상호작용하는 기술적 방식을 변경하지 않습니다. 이용 약관의 API 관련 조항과 마찬가지로, 이 업데이트는 악의적인 행위자에게 시행 가능한 기존 규칙을 더 완전히 설명하기 위한 것입니다.

버전 1.0

날짜: 2024년 8월 26일

API

위키미디어 재단은 운영자가 미디어위키 액션 API, 미디어위키 REST API, RESTBase API 등을 포함한 특정 API 사용에 대해 제한을 시행합니다. 이러한 제한 중 일부는 아래에 설명되어 있습니다. 본 정책의 제한은 API의 성능과 안정성을 유지하고, 서버 자원의 공정한 배분을 촉진하며, 커뮤니티 구성원이 자유 지식 운동을 진전시키기 위해 API를 사용할 수 있도록 하기 위해 존재합니다. 이 정책에 관한 자주 묻는 질문은 아래에서 읽을 수 있습니다.

이 정책에서 "운영자"는 우리의 API를 호출하게 하는 소프트웨어를 배포하는 모든 사람으로 정의됩니다. 다시 말해, 운영자는 API가 얼마나 자주 호출될지 통제합니다. 예를 들어, 이는 위키 내 "소도구"를 작성하는 사람들(실행하지 않더라도)과 봇을 운영하는 사람들(작성하지 않더라도)을 포함합니다. 만약 이것을 읽고 있으며 위키미디어 API를 사용하는 유용한 팁을 찾고 있다면, 아마도 당신이 이에 해당할 것입니다. 운영자의 사용에 제한이 부과된 경우, 그들은 이러한 제한을 우회해서는 안 됩니다. 예를 들어, 운영자는 API 응답에서 추가 요청을 지연하거나 속도를 줄이라는 모든 지시를 따라야 합니다. 특정 엔드포인트에 대한 구체적인 수치적 제한은 때때로 변경될 수 있습니다(예: 현재 및 예측된 미래 부하 변화에 따라).

위키미디어 API를 사용할 때 운영자는 다음을 준수해야 합니다:

1. 사용자 에이전트 정책을 따르고 그 외에는 사용자 에이전트를 올바르게 표시하세요;
2. 속도 제한 요청(예: 제한 알림)을 따르십시오;
3. 다운로드하거나 캐시된 데이터를 재게시할 때는 콘텐츠 라이선스 요구 사항을 따라야 합니다.

위키미디어 API를 사용할 때 운영자는 다음을 해서는 안 됩니다:

1. 동시 연결을 통해 위키미디어 API에 트래픽을 전송하여 타인의 서비스 저하를 초래하거나 사이트 안정성을 위협하는 행위;
2. 일반적인 사용 사례를 훨씬 초과하는 높은 빈도로 데이터를 요청하는 경우(예: 급증 또는 이 정책을 우회하기 위한 의도적인 방식);
3. 여러 사용자 에이전트에 위키미디어 API 요청을 분산하여 단일 운영자의 과도한 사용을 숨기기;
4. 단일 출처에서 발생하거나 특정 위키/리소스를 대상으로 하는 높은 트래픽을 보내어 다른 사용자가 해당 리소스를 사용하거나 접근하는 것을 차단하게 하기.

운영자는 이 정책 및 각 API에 대한 기타 기술 문서에 설명된 지침 내에서 당사의 API를 사용해야 합니다. 명확히 하자면, 이 정책의 존재는 위키미디어 커뮤니티 구성원이 이 정책에 부합하는 방식으로 API를 사용하기 전에 위키미디어 재단의 사전 허가를 받아야 한다는 것을 의미하지 않습니다. 오히려 우리는 운영자들이 자신의 API 사용에 차질을 빚을 수 있는 사용 사례를 인지하여, 위키미디어의 공유 자원을 올바르게 사용하는 방법을 알기를 바랍니다.

여기에 설명된 정책 범위를 벗어날 수 있는 사용 사례에 대해 예외나 설명을 받고 싶으시면 legalwikimedia.org로 요청을 제출해 주세요.

한계가 운영자의 사용에 영향을 미칠 수 있는 상황에서, 재단은 운영자에게 연락하여 한계의 성격과 필요한 예외 사항에 대해 논의할 수 있습니다. 이는 운영자의 스크립트가 사용자 에이전트 정책을 준수하고 최신 연락처 정보를 포함하는 경우에만 가능합니다.

재단은 이 정책을 API 접근 차단, 프로그램 비활성화 또는 이와 유사한 조치를 통해 시행할 권리를 보유합니다. 특정 상황에서 시행 조치를 취하거나 취하지 않는 결정은 이 정책에 따른 향후 조치에 대한 권리 포기가 아닙니다. 이 정책이 시행되는 상황에서 요청 당사자가 발생한 피해나 불공정성을 줄이기 위한 조치를 취할 경우, 재단의 재량에 따라 취해진 조치를 해제할 수 있습니다. 예를 들어:

• 전송 중인 API 요청의 비율을 줄이기;
• 지수 백오프를 구현하여 운영자에게 제한 알림을 전송하고, 이에 응답하여 자동으로 요청 속도를 늦추기; 또는
• 사용자 에이전트 정책에 따라 요구되는 사용자 에이전트 명명 규칙을 따르되, 사용에 문제가 발생할 경우 연락받을 수 있도록 하기.

하위 라이선싱

운영자(또는 그들을 대신하여 행동하는 자)는 위키미디어 재단이 관리하는 API의 가용성이나 기능성을 제3자에게 재라이선스, 임대, 양도 또는 보증할 수 없습니다. API의 최종 서비스 제공자(위키미디어 재단)의 신원을 흐리게 하는 방식으로 화이트 라벨링하는 API 클라이언트를 구현하는 것은 허용되지 않습니다. 명확히 하자면, 이 조항은 해당 콘텐츠가 적용되는 자유 라이선스에 따라 위키미디어 콘텐츠를 사용하고 재게시하는 것을 제한하지 않습니다.

지원 중단되는 API

재단은 API를 폐기하거나 수정할 수 있습니다. 서비스 종료 예정일 이후에도 API를 사용하는 운영자는 별도의 경고 없이 API를 사용할 수 없게 되거나 성능이 크게 저하될 수 있음을 예상해야 합니다. 운영자는 서비스 종료 예정일 이전에 적절한 대안을 사용하도록 업데이트해야 합니다. 재단은 사용자 에이전트 요구 사항에 따라 제공된 연락처 정보로 API 업데이트 및 폐기에 관한 공지를 제공할 수 있습니다.

이 정책의 수정

이 정책은 위키미디어 재단이 운영자들에게 위키미디어 API 사용에 대해 부과하는 현재 제한 사항 중 일부에 대한 공개 요약입니다. 따라서 위키미디어 재단은 현재 제한을 보다 완전히 설명하거나 향후 변경 사항을 반영하기 위해 재량에 따라 정책을 수정할 수 있습니다.

FAQ

위키미디어 API 정책에 어떤 변화가 있나요?

위키미디어 재단은 더 명확한 API 관리를 위한 지속적인 노력의 일환으로 API 정책의 언어를 업데이트하고 있습니다. 예를 들어, 헤더의 사용자 에이전트 관련 정책 페이지는 2010년 이후로 실질적인 업데이트가 이루어지지 않았습니다. 재단은 지난 10년간 API가 어떻게 관리되어 왔는지에 대해 투명성을 유지하기 위해, 기존 관리 정책을 전달하는 이 정책 페이지를 만들었습니다. 이 업데이트된 언어는 재단이 API를 관리하는 방식의 변화로 간주되어서는 안 됩니다. 대신, API가 이미 어떻게 관리되고 있는지에 대한 일부 내용을 명확히 하기를 바랍니다. 더 명확한 언어는 이미 고의적으로 규칙을 위반하는 악의적인 사용자와의 소통에 도움이 될 것입니다.

이 업데이트가 API를 사용한 개발에 영향을 미칠까요?

대다수의 사용자에게는 이러한 명확화가 API 사용 방식에 변화를 주지 않을 것입니다. 이는 기존 관행에 대한 보다 상세한 설명입니다. 따라서 API를 사용한 개발 과정에서 이전에 문제를 겪지 않았다면, 새로운 문제가 발생할 가능성도 낮습니다. 이 업데이트된 내용은 위키미디어 재단 API의 기능을 제한하지 않습니다. 극도로 높은 리소스 사용량을 가진 사용자는 새로운 내용이 재단의 리소스 관리 절차를 더 잘 이해하고 오류, 제한 및 차단을 피하는 데 도움이 될 수 있으므로 주목할 필요가 있습니다.

주요 변경 사항은 무엇인가요?

이러한 업데이트는 기존 기대사항(이전에 사용자 에이전트 정책 및 기타 문서 등에서 확인된)을 반영하므로, 위키미디어 재단은 새로운 문구가 이미 사실인 몇 가지 사항을 강조하기를 바랍니다. 예를 들어, API를 사용하는 개발자는 구체적으로 설명된 사용자 에이전트로 자신의 사용을 자체 식별해야 합니다. 매우 높은 사용량을 가진 사용자는 자신의 사용이 안전/보안/자원에 영향을 미친다는 점을 이해해야 하며, 이로 인해 연락처 정보가 포함된 사용자 에이전트를 표시하는 것이 더욱 중요해집니다. 매우 높은 사용량을 가진 사용자는 해당 사용이 더 이상 어떤 목적도 제공하지 않을 때 자발적으로 중단된 사용을 종료해야 합니다. 매우 높은 사용량을 가진 사용자는 기존 제한을 우회하려는 의도로 여러 에이전트를 병렬로 운영하여 기존 제한을 우회하는 것을 삼가야 합니다.

이것이 위키미디어 API의 "전략" 커뮤니티 사용자에게 어떤 영향을 미칠까요?

업데이트된 언어 정책은 위키미디어 커뮤니티 정책을 따르는 구성원들에게는 전혀 영향을 미치지 않을 것입니다. 위키미디어인들은 일반적으로 기술적 한계에 부딪히는 극도로 많은 양의 사용자 범주에 절대 속하지 않습니다. 선택적으로, 자신의 특정 사용에 대한 보장을 원하는 사람은 legalwikimedia.org로 요청을 제출할 수 있습니다.

만약 제가 위키미디어 API를 많이 사용하는 사용자라면, 접근이 제한될 수 있나요?

예. 저희는 시스템의 안정성과 보안을 보장하기 위한 조치를 마련해 두고 있습니다. 현재는 극도로 많은 양의 사용량을 가진 사용자들이 고빈도, 고자원 요청으로 API를 방해하지 않도록 피하는 방법을 이해할 수 있도록 이러한 제한을 설명하는 방식을 표준화하기 위해 노력하고 있습니다.

구체적인 예로, 우리의 사용자 에이전트 규칙이 이렇게 작동합니다. 단일 사용자가 API를 과도하게 사용하는 경우, 그리고 우리가 그 사용자가 누구인지 식별할 수 있다면(사용자가 사용자 에이전트 규칙을 따르고 연락처 정보를 포함했기 때문에), 우리는 함께 자원 집약적인 사용에 대한 해결책을 찾을 수 있을 것입니다. 개발자가 그 규칙을 따르지 않는다면, 상호 협력하여 해결책을 찾을 방법이 없습니다.

자원 도구와 봇도 영향을 받나요?

우리는 많은 자원봉사자들이 개발한 도구와 봇이 다양한 작업을 위해 위키미디어 API에 의존하고 있다는 것을 알고 있으므로, 이러한 사용이 이전에 문제를 일으키지 않았다면 앞으로도 그럴 가능성은 낮습니다. 이 업데이트는 정책을 명확히 하기 위한 것입니다. 선택적으로, 자신의 특정 사용에 대해 확신을 얻고 싶은 사람은 legalwikimedia.org로 요청을 제출할 수 있습니다.

이 언어가 기존 정책을 단순히 재진술하는 것이라면, 왜 업데이트되고 있나요?

여러 가지 이유가 있으며, 모두 이미 모범 사례를 따르는 사람들에게 서비스 품질을 향상시키는 데 유용합니다.

먼저, 규칙이 무엇인지 가능한 한 명확하게 설명하는 것은 매우 많은 리소스를 사용하는 개발자들이 해당 규칙을 위반하지 않도록 돕는 데 매우 효과적입니다. 추가 정보는 이러한 사용자들에게 예측 가능성을 높여줍니다. 선의를 가진 운영자들이 기존 규칙을 더 잘 인식한다면, 재단의 API 관리자들의 업무 부담이 줄어들 수 있을 것입니다.

둘째, 이는 현재 보편적으로 따르지 않고 있는 유용한 정책을 강조하려는 시도입니다. 예를 들어, 극도로 높은 리소스 사용자가 기존 사용자 에이전트 정책을 따라야 한다는 규칙을 부각시키면 악의적인 사용에 대응하려고 할 때 선의의 사용자를 의도치 않게 방해하는 상황을 피할 수 있습니다.

마지막으로, 악의적인 개발자에게 적합한 것과 그렇지 않은 것을 명확히 하기 위한 규칙 재정의가 시도됩니다.

이러한 변경 사항이 연구자들에게 어떤 영향을 미칠까요?

이 정책을 따르는 연구자들에게는 영향을 미치지 않을 것입니다. 우리는 연구자, 개발자, 소규모 조직에게 우리 API의 중요성을 잘 알고 있습니다. *현재* 선의의 연구 관련 사용이 제한된 사례를 알지 못하기 때문에 *향후* 선의의 연구 관련 사용이 제한될 가능성은 낮아 보입니다.

이 업데이트가 "빅 테크" API 사용자에게 영향을 미칠까요?

정책을 따르지 않을 경우 그럴 가능성이 있습니다. 이 업데이트에 설명된 기존 규칙을 따르지 못하거나 따르지 않기로 선택한 대량 사용자는 대량 사용 사례 및/또는 SLA가 필요한 사용 사례를 지원하기 위해 만들어진 엔터프라이즈 API에서 해결책을 찾을 수 있습니다.

업데이트된 정책에서 구체성을 강조하는 이유는 무엇인가요?

정책을 더 구체적으로 만들어 사용자가 API 사용에 대한 기술적 제한을 피하기 위해 무엇을 해야 하고 하지 말아야 하는지 명확히 이해할 수 있도록 하는 것이 목표입니다. 이를 통해 모든 API 사용자에게 더 원활하고 효율적인 상호작용을 보장하고자 합니다.