MikeRalphson

{
	"info": {
		"_postman_id": "64db4d98-d050-4f4b-8a02-86be628160f9",
		"name": "Cognitive Search API - User Group",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
		"_exporter_id": "641744"
	},
	"item": [
		{
			"name": "Create SharePoint Data Source",

MikeRalphson

[
  {
    "title": "PayPal Here",
    "link": "https://explore.postman.com/team/paypalhere",
    "image": "https://static.getpostman.com/assets/apinetwork/paypalhere-logo.png"
  },
  {
    "title": "Imgur",
    "link": "https://explore.postman.com/team/imgur",
    "image": "https://static.getpostman.com/assets/apinetwork/imgur-logo.png"

MikeRalphson

# https://github.com/BretFisher/jekyll-serve/blob/main/README.md license: MIT
FROM ruby:3.1-slim-bullseye as jekyll

RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    git \
    && rm -rf /var/lib/apt/lists/*

# used in the jekyll-server image, which is FROM this image
COPY docker-entrypoint.sh /usr/local/bin/

MikeRalphson

https://aiception.com/static/swagger.json @AIception
https://docs.api.video/openapi/5f0d4679158b8d006ea6f068 
https://appwrite.io/specs/open-api3?platform=client 
https://appwrite.io/specs/open-api3?platform=server 
https://ato-team.github.io/business-registries-rest-api-specification/swagger.yaml 
http://api.aviationdata.systems//swagger/docs/v1 @aviationdataSYS
http://support.beanstream.com/restapi/swagger.json 
https://budgea.biapi.pro/2.0/doc/ 
https://a.blazemeter.com/api/v4/explorer/resources.json @BlazeMeter
http://ccsapi-doc.mybluemix.net/swagger.json 

MikeRalphson

openapi: 3.1.0
info:
  version: 1.0.0
  title: API
jsonSchemaDialect: 'http://json-schema.org/draft-04/schema#'
components:
  schemas:
    draft4:
      exclusiveMaximum: true
    draft202012:

MikeRalphson

State of OAI

• The website: https://openapis.org
• The GitHub repositories: https://github.com/OAI
  • Includes the OAS, overlays, the Getting Started documentation
• GitHub issues, discussions and pull-requests
• The rendered version of the spec: https://spec.openapis.org/oas/latest.html
• https://github.com/isa-group/SLA4OAI-Specification
• Slack - contact us for access today

MikeRalphson

{
  "openapi": "3.0.1",
  "info": {
    "title": "SoundCloud Public API Specification",
    "contact": {
      "name": "API issue tracker",
      "url": "https://github.com/soundcloud/api"
    },
    "version": "1.0.0",
    "termsOfService": "https://developers.soundcloud.com/docs/api/terms-of-use"

MikeRalphson

type: string

MikeRalphson

// based on https://hacks.mozilla.org/2015/07/es6-in-depth-proxies-and-reflect/

function Tree(base = {}) {
  return new Proxy(base, treeHandler);
}

const treeHandler = {
  get: function (target, key, receiver) {
    if (!(key in target) && key !== 'toJSON' && key !== Symbol.iterator) {
      target[key] = Tree(); // auto-create a sub-Tree

MikeRalphson

const yaml = require('yaml');
const recurse = require('reftools/lib/recurse.js').recurse;

const ast = yaml.parseDocument(inputStr);

recurse(ast,{},function(obj,key,state){
  let comment;
  if (obj[key] && obj[key].commentBefore) {
    comment = obj[key].commentBefore;
  }