openapi: 3.0.3
info:
title: Superhero API (akabab) Appearance Connections API
description: 'Open-source static REST API exposing 731 superheroes and villains from
multiple comic universes (Marvel, DC, Dark Horse, Image, and more) as
pre-built JSON files served from GitHub Pages and the jsDelivr CDN.
All endpoints are unauthenticated GETs.
'
version: 0.3.0
contact:
name: akabab/superhero-api
url: https://github.com/akabab/superhero-api
license:
name: MIT
url: https://github.com/akabab/superhero-api/blob/master/LICENSE
servers:
- url: https://akabab.github.io/superhero-api/api
description: Primary origin (GitHub Pages)
- url: https://cdn.jsdelivr.net/gh/akabab/superhero-api@0.3.0/api
description: jsDelivr CDN mirror
tags:
- name: Connections
description: Per-character group affiliations and relatives.
paths:
/connections/{id}.json:
get:
operationId: getCharacterConnections
summary: Get Character Connections
description: Returns just the connections slice for a single character (group affiliations and relatives).
tags:
- Connections
parameters:
- $ref: '#/components/parameters/CharacterId'
responses:
'200':
description: The character's connections sub-document.
content:
application/json:
schema:
$ref: '#/components/schemas/Connections'
'404':
description: No character with the supplied id exists.
components:
parameters:
CharacterId:
name: id
in: path
required: true
description: Numeric character id, 1..731.
schema:
type: integer
minimum: 1
maximum: 731
schemas:
Connections:
type: object
description: Group affiliations and family connections.
properties:
groupAffiliation:
type: string
description: Group/team affiliations.
relatives:
type: string
description: Known relatives.