kbendick commented on a change in pull request #3561:
URL: https://github.com/apache/iceberg/pull/3561#discussion_r760684704



##########
File path: rest_docs/rest-catalog-v0.1-SNAPSHOT.md
##########
@@ -0,0 +1,1810 @@
+---
+title: Apache Iceberg REST Catalog API v1.0.0
+language_tabs:
+  - shell: Shell
+  - java: Java
+language_clients:
+  - shell: ""
+  - java: ""
+toc_footers: []
+includes: []
+search: true
+highlight_theme: darkula
+headingLevel: 2
+
+---
+
+<!-- Generator: Widdershins v4.0.1 -->
+
+<h1 id="apache-iceberg-rest-catalog-api">Apache Iceberg REST Catalog API 
v1.0.0</h1>
+
+> Scroll down for code samples, example requests and responses. Select a 
language for code samples from the tabs above or the mobile navigation menu.
+
+Defines the specification for the first version of the REST Catalog API. 
Implementations should support both Iceberg table specs v1 and v2, with 
priority given to v2.
+
+Base URLs:
+
+* <a href="http://127.0.0.1:1080";>http://127.0.0.1:1080</a>
+
+License: <a href="https://www.apache.org/licenses/LICENSE-2.0.html";>Apache 
2.0</a>
+
+# Authentication
+
+- HTTP Authentication, scheme: bearer 

Review comment:
       So these markdown files are autogenerated by a separate tool.
   
   For now, I just stuck bearer token in there as a means of indicating some 
kind of HTTP Authentication header at the least. I'll look into how to add a 
configurable section to the OpenAPI document itself. 




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to