Public API documentation
ktct.me exposes a small set of public HTTP APIs for contact-page QR codes and vCard downloads. Authenticated owner and billing endpoints are not part of this catalog.
Discovery
- API catalog (RFC 9727): /.well-known/api-catalog
- Status: /api/status
QR Code API
GET /api/qr/{person} returns a PNG QR code that encodes the public contact page URL for the given slug.
- OpenAPI: /openapi/qr.json
- Example: /api/qr/example-nails
- Rate limit: 60 requests / minute / IP
vCard API
GET /api/vcard/{person} returns a .vcf attachment when the page owner's plan allows visitor contact saving (paid plans and demo pages). Free-plan pages respond with 403.
- OpenAPI: /openapi/vcard.json
- Example: /api/vcard/example-nails
- Rate limit: 30 requests / minute / IP
