Tarif Účetní

Napojení a čtecí API

Tarif Účetní je 1 000 IČO a 590 Kč měsíčně. Provozovatel není plátce DPH. Napojení cenu nemění. Free, Start a Pro napojení nemají.

Adresu a tajemství nastavíte po přihlášení v účtu. Heslo k napojení se ukáže jen při vytvoření. Uschovejte si ho, znovu ho nezobrazíme.

Kdy oznámení odejde

Jen když denní kolo uloží rozdíl snímku partnera. Výpadek zdroje rozdíl není a oznámení nespustí. Zkušební tlačítko pošle událost test. Neúspěch se třikrát opakuje s čekáním 1 s a 2 s. Adresa musí být veřejná adresa na internetu.

Podpis je HMAC-SHA256 surového těla odpovědi, hex v hlavičce X-Icohlidac-Signature. Ověřujte bajty, které přišly, ne znovu složené JSON.

Seznam partnerů

curl -sS \
  -H "Authorization: Bearer ih_TOKEN" \
  "https://váš-icohlídač/api/v1/subjekty"

Historie změn je GET /api/v1/zmeny a pro jedno IČO GET /api/v1/zmeny?ico=27074358. Zápis přes API není. Nad 60 požadavků za minutu na jeden token je odpověď 429. Adresu ve příkazu nahraďte adresou svého IČO Hlídače.

Ověření podpisu v Pythonu

import hashlib
import hmac

def podpis_sedi(telo: bytes, hlavicka: str, tajemstvi: str) -> bool:
    spocteno = hmac.new(tajemstvi.encode("utf-8"), telo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(spocteno, hlavicka.strip())

Ověření podpisu v PHP

<?php
$telo = file_get_contents("php://input");
$hlavicka = $_SERVER["HTTP_X_ICOHLIDAC_SIGNATURE"] ?? "";
$spocteno = hash_hmac("sha256", $telo, $tajemstvi);
$ok = hash_equals($spocteno, $hlavicka);

Ceník · Stránka pro účetní · Otázka ve FAQ