API Reference

Complete reference for the GlyphNet API.

Base URL

https://api.glyphnet.io

All endpoints use HTTPS. HTTP requests will be redirected.

Authentication

All requests require an API key in the X-API-Key header:

curl -H "X-API-Key: gn_live_your_key_here" https://api.glyphnet.io/v1/verify

See Authentication for details.

Endpoints

Verification

Method	Endpoint	Description
POST	`/v1/verify`	Verify claims in text
POST	`/v1/harm/detect`	Detect harmful content

API Keys

Method	Endpoint	Description
GET	`/v1/keys`	List your API keys
POST	`/v1/keys`	Create a new API key
DELETE	`/v1/keys/{id}`	Revoke an API key

Usage

Method	Endpoint	Description
GET	`/v1/usage`	Get usage statistics

Health

Method	Endpoint	Description
GET	`/health`	Service health check

Request Format

All POST requests must include:

Content-Type: application/json header
JSON-encoded body

curl -X POST https://api.glyphnet.io/v1/verify \
  -H "X-API-Key: gn_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"text": "Your text here"}'

Response Format

All responses are JSON:

{
  "request_id": "req_abc123",
  "data": { ... },
  "processing_time_ms": 45
}

Error Responses

{
  "error": "error_code",
  "message": "Human-readable description",
  "details": { ... }
}

See Error Codes for all possible errors.

Rate Limiting

Rate limits depend on your plan:

Plan	Requests/Minute	Monthly Limit
Free	60	1,000
Starter	200	50,000
Professional	500	500,000
Enterprise	2,000	10,000,000

Rate limit headers are included in every response:

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 195
X-RateLimit-Reset: 1705320000

Versioning

The current API version is v1. The version is included in the URL path:

https://api.glyphnet.io/v1/verify

We maintain backwards compatibility within major versions.

SDKs

Official SDKs are available:

Authentication Authentication