REST API 환경에 대한 업데이트 발표
이 게시물은 docs.microsoft.com 팀의 프로그램 관리자인 Jessie Huang이 작성했습니다.
오늘 docs.microsoft.com에서 REST 환경에 대한 두 가지 주요 개선 사항 릴리스를 발표하게 되어 기쁩니다.
- REST API 브라우저의 미리 보기 버전--Microsoft에서 개발한 REST API를 쉽게 검색하여 찾을 수 있는 방법입니다.
- REST 사용해 보기--즐겨찾는 웹 브라우저에서 직접 REST API를 사용해 볼 수 있는 대화형 환경입니다.
한 위치에서 REST API 검색
.NET, PowerShell, Python 또는 JavaScript 같은 기존 API 브라우저 환경에 이미 익숙한 경우 편안하게 새 릴리스를 사용할 수 있습니다. 포커스가 지정되지 않은 검색 환경에 의존할 필요 없이 다양한 REST API에 대한 설명서를 신속하게 얻을 수 있습니다. API 브라우저를 사용하면 몇 초 안에 올바른 API를 찾아 빠르게 작업을 진행할 수 있습니다.
이전에는 docs.microsoft.com에서 특정 REST API 설명서를 찾는 경우 사이트 전체 검색을 통해 찾거나 콘텐츠 페이지의 탐색 구성 요소(예: 목차)를 사용해야 했습니다. 이 방법은 시간이 많이 걸릴 수 있으며 찾으려는 것을 정확히 알고 있는 경우에는 더욱 더 시간이 많이 걸릴 수 있습니다. Microsoft는 이 문제를 개선하고 싶었습니다.
오늘부터 중앙의 한 위치(https://docs.microsoft.com/rest/api)에서 훨씬 더 효율적인 방식으로 Microsoft REST API를 검색할 수 있습니다. 드롭다운에서 서비스를 선택하여 사용 가능한 모든 서비스 API를 찾기만 하면 됩니다.
여러 번 클릭할 필요 없게 하고 싶나요? 가장 자주 사용되는 일부 API의 경우 언제나 빠른 필터를 사용할 수 있습니다. 필터 중 하나를 클릭하면 지정된 서비스에 대한 포괄적인 API 집합이 최신 릴리스로 곧바로 표시됩니다.
검색 환경은 정확한 키워드를 알고 있는지에 관계 없이, 심지어 포함된 서비스를 모르는 경우에도 필요한 API 정보를 찾을 수 있는 방식으로 디자인되었습니다. 기본적으로 docs.microsoft.com에서는 문서화된 모든 API에서 검색이 수행됩니다. 서비스를 선택한 경우에만 해당 서비스의 범위 내에서 검색이 수행됩니다.
한 번에 여러 키워드를 검색해야 하나요? 그것도 가능합니다.
브라우저에서 Azure REST API 사용해 보기
관심 있는 Azure API를 찾았지만 시나리오를 빌드하는 데 도움이 되는 것인지 알 수 없나요? docs.microsoft.com에서는 오늘부터 브라우저에 직접 Azure REST API를 사용해 볼 수 있으므로 걱정하지 마세요.
녹색의 사용해 보기 단추를 누르기만 하면 됩니다.
REST API에 대해 사용해 보기를 선택하면 포커스가 있는 보기로 이동하여 다른 매개 변수 값 또는 요청 본문으로 실험할 수 있습니다. 페이지의 왼쪽 위 모서리에 있는 콘텐츠 햄버거 메뉴를 사용하여 쉽게 문서 컨텍스트를 변경할 수 있습니다.
피드백을 보내주세요.
단기적으로 구현할 계획인 개선 사항이 많이 있으므로 이 환경은 최종적인 것은 아닙니다. 예를 들어 Azure REST API 외에도 사용해 보기를 지원할 수 있습니다. REST 환경을 개선할 수 있는 방법을 알려주세요. 바로 새 이슈를 열고, 최대한 빨리 다시 연락드리겠습니다.
또한 Twitter 계정에 따라 최신 업데이트 및 알림을 받으실 수 있습니다.
개발자를 위한 더 나은 세상을 만들려면 팀에 합류해 주세요!