Skip to content

Instantly share code, notes, and snippets.

View kinlane's full-sized avatar

Kin Lane kinlane

View GitHub Profile
@kinlane
kinlane / capabilities.json
Created November 21, 2025 01:04
capabilities.json
{
"$id": "https://github.com/naftiko/capabilities/blob/main/schema.yml",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "Capability",
"description": "Capabilities are open-source, declarative, standards-based integrations that are aligned with business outcomes within specific domains, providing what is needed to deliver and automate integrations across a variety of use cases.",
"type": "object",
"required": [
"info"
],
"properties": {
rules:
apis-json-apis-properties-apiop-cycles-business-impact-canvas-info:
description: >-
This ensures that an API has had the APIOps Business Impact Canvas applied
to the API, requiring that the canvas is present in the repository and
registered in the APIs.json index for the API, helping with discovery and
governance.
message: Has APIOps Cycles Business Impact Canvas
severity: info
given:
@kinlane
kinlane / apis.yml
Created April 2, 2025 22:10
APIOPs Cycles Canvases for Product API
aid: api-evangelist-products
name: Products
type: Template
description: |-
This is a template APIs.json for a products API, to be used in storytelling, training, and knowledge bases.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Application Programming Interface
- API
@kinlane
kinlane / spectral-default-ruleset.yml
Created March 13, 2025 22:16
Spectral Default Ruleset
documentationUrl: https://meta.stoplight.io/docs/spectral/docs/reference/openapi-rules.md
formats:
- oas2
- oas3
- oas3_0
- oas3_1
aliases:
PathItem:
- $.paths[*]
OperationObject:
@kinlane
kinlane / providers.yaml
Created January 29, 2025 15:13
GitHub Providers
---
- name: Adidas
grade: B
url: https://github.com/adidas/api-guidelines
- name: Adyen
grade: B
url: https://github.com/Adyen/adyen-openapi
- name: Alchemy
grade: B
url: https://github.com/alchemyplatform/docs-openapi-specs
@kinlane
kinlane / product-json-schema.yml
Created January 7, 2025 22:52
product-json-schema
$schema: https://json-schema.org/draft/2020-12/schema
title: Product
description: This is a Schema.org compliant demo product schema.
type: object
required:
- identifier
- name
- description
properties:
identifier:
@kinlane
kinlane / json-schema-spectral-rules-1.yml
Last active November 21, 2024 17:55
json-schema-spectral-rules-1
---
rules:
# ID
json-schema-2020-12-id-error:
description: Schema MUST have a unique identifier for each object.
message: Schema MUST Have a $id.
severity: error
given: $
then:
@kinlane
kinlane / add-api-test.json
Last active November 14, 2024 23:46
add api test json
{
"aid": "test-add-6",
"name": "Testing Adding 666 API",
"type": "Contract",
"description": "This is a contract APIs.json, providing a boilerplate contract that an API consumer, or potential API consumer can use to express what is expected when one company provides an API to another company.",
"image": "https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg",
"tags": [
"Application Programming Interface",
"API",
"Contract"
@kinlane
kinlane / add-api-test.yml
Created November 14, 2024 22:31
Add API Test
aid: test-add-1
name: Testing Adding API
type: Contract
description: |-
This is a contract APIs.json, providing a boilerplate contract that an API consumer, or potential API consumer can use to express what is expected when one company provides an API to another company.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Application Programming Interface
- API
@kinlane
kinlane / arazzo-json-schema.yml
Created October 26, 2024 17:45
Arazzo JSON Schema
$id: 'https://spec.openapis.org/arazzo/1.0/schema/2024-08-01'
$schema: 'https://json-schema.org/draft/2020-12/schema'
description: |-
The description of OpenAPI Initiative Arazzo v1.0.0 documents
without schema validation, as defined by https://spec.openapis.org/arazzo/v1.0.0
type: object
properties:
arazzo:
description: The version number of the Arazzo Specification
type: string