Skip to content

Instantly share code, notes, and snippets.

View kinlane's full-sized avatar

Kin Lane kinlane

View GitHub Profile
@kinlane
kinlane / api-commons-snack-for-ai-send-twilio-message.yml
Last active September 27, 2024 18:01
API Commons API Snack for AI - Send Twilio Message
aid: api-commons
name: API Commons API Snack for AI - Send Twilio Message
type: Snack
description: |-
This is an API Commons Snack for artificial intelligence, providing a single API-powered capability that can be used via artificial intelligence applications.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Twilio
- Messages
created: '2024-09-27'
@kinlane
kinlane / problem-details-for-http-apis
Created September 27, 2024 13:27
Problem Details for HTTP APIs
openapi: 3.1.0
info:
title: Problem Details for HTTP APIs
description: |
This is a base OpenAPI for the Problem Details for HTTP APIs, as a way to carry machine-readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs. This was originally developed by Bump.sh as part of their [Train Travel API template](https://bump.sh/bump-examples/doc/train-travel-api), but reduced here to provide a base just for showcasing Problem Details for HTTP APIs.
version: 1.0.0
contact:
name: API Evangelist
url: https://apievangelist.com
email: info@apievangelist.com
@kinlane
kinlane / apis-io-engineering-api-platform.yaml
Created September 23, 2024 19:07
APIs.io Engineering API Platform
aid: apis-io-engineering-platform
name: APIs.io Engineering Platform
type: Platform
description: |-
This is an index of all of the infrastructure and services used to operate the engineering side of APIs.io, providing a single manifest of all the 3rd-party suppliers we depend on for digital resources and capabilities.<br><br>The goal of this engineering platform definition is to define the platform in a way that can be federated and distributed as part of API operations, helping educate teams where they can access platform resources.
tags:
- APIs.io
- Engineering
- Platform
created: '2024-09-06'
@kinlane
kinlane / api-commons-train-travel-openapi-spectral-rules.yaml
Created August 5, 2024 19:18
api-commons-train-travel-openapi-spectral-rules
rules:
openapi-openapi-version-310-info:
description: Has latest version of OpenAPI.
message: 3.1.0 Version of OpenAPI
severity: info
given: $
then:
field: openapi
function: pattern
functionOptions:
@kinlane
kinlane / api-commons-train-travel-openapi-spectral-rules.yaml
Last active August 5, 2024 19:20
api-commons-train-travel-openapi-spectral-rules
rules:
apis-json-name-negative:
description: Name of APIs.json
message: There MUST be a name.
severity: error
given: $
then:
field: name
function: truthy
apis-json-name-positive:
@kinlane
kinlane / apis-json-contract.yml
Created July 9, 2024 23:59
apis-json-contract
aid: api-json-contract
name: API Contract
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 / api-commons-train-travel-openapi.yaml
Created July 7, 2024 22:06
api-commons-train-travel-openapi
openapi: 3.1.0
info:
title: Train Travel API
description: |
API for finding and booking train trips across Europe.
## Run in Postman
Experiment with this API in Postman, using our Postman Collection.
@kinlane
kinlane / api-commons-train-travel-apis-json.yaml
Last active August 2, 2024 17:46
api-commons-train-travel-apis-json
aid: base-train-travel
name: Train Travel
type: Base
description: |-
This is a template APIs.json for the excellent Train Travel API developed by the folks over at Bump.sh. It is mean to be used as a base template for creating other APIs, establishing a "base" for all of the open source APIs within the commons.
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Application Programming Interface
- API
- Train Travel
@kinlane
kinlane / api-commons-interface-license.json
Last active June 30, 2024 22:43
API Commons Interface License
{
"version": "2.0.0",
"apis": [
{
"name": "API Commons",
"description": "The API that returns of list of APIs that are in the API Commons, and allows you to add a manifest for an API.",
"image": "https://s3.amazonaws.com/kinlane-productions2/api-commons/api-commons-icon.png",
"tags": [
"API",
"License"
@kinlane
kinlane / twilio-apis-json-blueprint.yaml
Created June 30, 2024 16:55
Twilio APIs.json Blueprint
name: Twilio
description: Needs a description.
image: https://kinlane-productions2.s3.amazonaws.com/apis-json-icons/apis-json.png
url: https://example.com/apis/apis.yml
type: Blueprint
created: 2024-6-30
modified: 2024-6-30
specificationVersion: '0.18'
tags:
- Tag