api-guidance.md
API Evangelist Network API
Editorial guidance across the history, technology, business, politics, governance, and evangelism of APIs.
GET https://api.apievangelist.com/v1
/guidance/sections/history
Guidance from the history of APIs — the providers, tooling, and moments that shaped the space.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged History.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/sections/technology
Guidance on the technology of APIs — protocols, patterns, and the technical landscape.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged Technology.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/sections/business
Guidance on the business of APIs — monetization, plans, partners, and go-to-market.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged Business.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/sections/politics
Guidance on the politics of APIs — regulation, privacy, terms of service, and power.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged Politics.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/sections/governance
Guidance on API governance — aligning policies, rules, and lifecycle across operations.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged Governance.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/sections/evangelism
Guidance on API evangelism — carrying the API message and earning adoption.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
fields
string
Comma-separated sparse field projection.
200
Paged guidance tagged Evangelism.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance
Search or browse the full guidance collection (177) — editorial guidance for API producers and consumers.
q
string
Free-text query over title, summary, tags, and body.
tags
string
Comma-separated tag slugs.
match
string · enum
Tag match mode.
Enum values: any
all
Default: any
fields
string
Comma-separated sparse field projection.
page
integer · min: 1
Default: 1
limit
integer · min: 1 · max: 100
Default: 25
200
Paged guidance.
meta
object
data
Doc[]
GET https://api.apievangelist.com/v1
/guidance/{slug}
One entry from the guidance collection; include=content adds the full body.
slug
string · required
include
string · enum
Set to content to inline the full markdown body (up to 200 KB).
Enum values: content
200404
The entry.
type
string
slug
string
title
string
summary
string
url
string · uri
tags
string[]
date
string
content
string
Full markdown body when include=content.