Публичният API използва същия versioned calculation engine като основния калкулатор. Не изпращайте лични, здравни или идентификационни данни.
Версии на правилата
GET /wp-json/bgk/v1/rules връща публичните идентификатори, периоди, граници и дата на проверка. Отговорът може да се кешира публично за 3600 секунди.
Изчисление
POST /wp-json/bgk/v1/calculate приема JSON. Пример:
{"amount_eur":"3000,50","direction":"gross_to_net","mode":"monthly","ruleset":"2026-08","birth_group":"after_1959","telk_50":false,"tzpb_rate":0.004}direction: gross_to_net или net_to_gross. mode: monthly, yearly или hourly. ruleset: 2026-01 или 2026-08. Числата приемат точка, запетая и разделящи интервали, но не приемат текст, масиви, отрицателни или неограничено големи стойности.
Отговор и грешки
Успешният отговор съдържа success: true, версията на правилата, входния сценарий, ставки, уведомления и scaled стойности в EUR и BGN. Невалиден вход връща контролиран HTTP 400; ограничена честота може да върне 429. Изчислителните отговори са no-store.
Поверителност и стабилност
API не създава профил и приложението не записва входа или резултата в WordPress базата. Интеграциите трябва да пазят ruleset и да обработват контролирано бъдещи версии. Вижте методологията и политиката за поверителност.