Firmify Public API Changelog

Формат и версиониране

Този changelog следва Keep a Changelog формат. Версионирането на API-то е на /api/v1 — breaking changes ще дойдат в /api/v2.

---

История на промените

2026-07-14

Added

• Redoc UI на /api/v1/docs/redoc (и /v1/docs/redoc)
• Postman collection на /api/v1/postman.json
• Changelog страница (/guide/api-changelog)
• Актуализирани ръководства за разработчици (BG + EN)

Changed

• OpenAPI описание: API Pro quota 30 docs/month (съответства на конфигурацията)
• Developer portal quick-start: canonical legal-docs flow

---

2026-07-13 — Public API v1.1.0

Added

• Пълен /api/v1/* surface: 11 категории документи
• Hybrid billing: API Pro → key tier → credits → Stripe checkout/charge
• Webhooks: payment.completed, doc.generated, doc.failed, job.completed, job.failed
• Idempotency-Key header (24h TTL)
• Async jobs: POST /docs/generate, GET /jobs/{id}
• Utility endpoints: /catalog, /estimate, /batch, /analytics
• Headless signup: POST /api/v1/register
• Sandbox API keys
• OpenAPI 3.1.1 spec с 100+ documented paths
• Scalar + Swagger UI на /api/v1/docs

Changed

• Canonical base path: /api/v1/* (mirror /v1/*)

Deprecated

• /developer/v1/docs/* — връща 410 Gone; използвайте /api/v1/docs/*

---

2026-07-02 — Public API v1.0 (initial)

Added

• API key auth (fmfy_...)
• Developer portal (/developer)
• Legal-docs и HR-docs programmatic generation
• Stripe Checkout integration

---

Поддръжка

Въпроси: api@firmify.bg · Developer Portal · OpenAPI