Apicurio-studio: github에서 기존 모델을 열려고 할 때 페이지를 찾을 수 없음 오류가 발생했습니다.

안녕하세요 피드백 주셔서 감사합니다. 불행히도 현재 Apicurio는 YAML 읽기/쓰기를 지원하지 않습니다. 여기에 대한 기능 요청이 있습니다.

https://github.com/Apicurio/apicurio-studio/issues/165

하는 것은 어렵지 않지만 대기열에 있는 것보다 앞서 몇 가지 다른 개선 사항이 있습니다. :)

해결 방법으로 YAML에서 JSON으로 변환하고 결과를 GitHub에 저장한 다음 열어볼 수 있습니다. 짜증나는 건 알지만, 우리가 apicurio에 추가 기능을 추가할 수 있을 때까지는 작동할 것입니다.

참고: API 추가/가져오기 시 더 나은 오류 메시지가 필요하기 때문에 이것은 여전히 ​​유효한 버그 보고서입니다. 자원을 찾을 수없는 경우 (URL에서 가져올 때 예) 우리는 ( "페이지를 찾을 수 없습니다"오류를보고하지 않음) 것을보고해야합니다. 리소스가 있지만 형식이 잘못된 경우 다르게 보고해야 합니다.

OpenAPI 3 JSON 또는 위에 링크된 예제가 오늘 작동하지 않습니다. URL에서 가져오기가 작동하지 않는 경우:

https://github.com/Apicurio/apicurio-studio/blob/master/back-end/hub-api/src/test/resources/io/apicurio/hub/api/beans/simple-api-3.0.json

또는

https://github.com/david4096/data-object-schemas/blob/openapi3/openapi/data_objects_service.openapi.json

안녕하세요 @david4096 - 해당 URL에 실제로 콘텐츠가 없기 때문에 첫 번째 URL이 실패했습니다. 적어도 해당 링크를 클릭하면 파일이 없습니다. 실제로 해당 모듈의 src/test 내에 resources 폴더가 없습니다.

https://github.com/Apicurio/apicurio-studio/tree/master/back-end/hub-api/src/test

그러나, 두 번째 URL에서 분명히 내용이있다. Apicurio에서 작동하지 않는 이유는 불행히도 아직 분기(마스터만)에서 콘텐츠 가져오기를 지원하지 않기 때문입니다. 이것은 브랜치를 지원하는 것이 어렵지 않기 때문에 분명히 누락된 기능입니다.

즉, 우리는 각각의 API를 통해 다양한 소스 제어 시스템 대신 임의의 URL에서 API 디자인을 추가/가져오기할 수 있는 방향으로 가고 있다고 생각합니다. 데이터를 저장하기 위해 이러한 시스템에 더 많이 의존할 때부터). "URL에서 가져오기" 기능의 우선순위를 높여 다음 버전에 포함시키겠습니다.

현재로서는 해결 방법으로 할 수 있는 것은 추가/가져오기하려는 API를 github 저장소의 마스터 브랜치에 저장하고(아마도 이 목적을 위한 저장소를 생성할 수 있음) 거기에서 가져오는 것입니다.

소스 제어에서 분기를 지원하는 티켓을 추가했습니다.

https://github.com/Apicurio/apicurio-studio/issues/222

그러나 임의의 URL에서 콘텐츠를 가져오는 것이 더 유용한 기능이라고 생각하므로 먼저 해결하겠습니다.

안녕하세요 @EricWittmann 설명 감사합니다!