Developer Documentation
Integrate BLEFYI data into your applications. Free JSON API — no authentication required, CORS enabled.
API Endpoints
All endpoints return JSON. No authentication required. CORS enabled for cross-origin requests.
| Method | Endpoint | Description | Cache |
|---|---|---|---|
| GET | /api/v1/chips/ |
Paginated list of all ble chips | 1h |
| GET | /api/v1/chips/{slug}/ |
Ble Chip detail by slug | 1h |
| GET | /api/v1/search/?q= |
Search across all content | 5m |
| GET | /api/v1/random/ |
Random ble chip slug and URL | 1h |
| GET | /api/v1/glossary/ |
Glossary terms for this site | 1h |
| GET | /api/v1/content/ |
Content articles (guides, blog posts) | 1h |
| GET | /api/openapi.json |
OpenAPI 3.1.0 specification | 1h |
Quick Start
Try it now:
curl -s 'https://blefyi.com/api/v1/chips/?limit=2'Response fields: name, slug
AI / LLM Integration
/llms.txt— Machine-readable site summary- All page URLs support
.mdsuffix for markdown output - OpenAPI spec at
/api/openapi.json
SEO & Standards
- Sitemap Index — All URLs
- robots.txt — Crawler rules
- security.txt — Security contact (RFC 9116)
- JSON-LD structured data on all pages
- hreflang tags — 15 languages
OpenAPI Specification
Full API spec: https://blefyi.com/api/openapi.json
OpenAPI 3.1.0 compatible — import into Postman, Swagger UI, or any OpenAPI client.
Rate Limits & Usage
- No authentication required
- Please include a
User-Agentheader - Respect cache headers — responses include
Cache-Control - For bulk data, prefer paginated list endpoints over repeated detail requests