Příručka
Synchronizace a souběžné změny
Čtěte jen změny a nepřepisujte cizí úpravy.
Pro zrcadlení dat do jiného systému nečtěte pokaždé všechno. Uložte si čas poslední synchronizace a čtěte jen to, co se od něj změnilo. Znak + v časové zóně zapište v adrese jako %2B:
curl "https://api.fakturanet.cz/v1/invoices?updated_since=2026-11-18T09:30:00%2B01:00&limit=100" \
-H "Authorization: Bearer $FAKTURANET_API_KEY"
- Seznam s
updated_sinceje seřazený od nejstarší změny a obsahuje i smazané záznamy; ty mají vyplněnédeleted_at. Funguje pro doklady, kontakty i výdaje. - Projděte všechny stránky podle
links.next. Další synchronizaci začněte od největšíhoupdated_at, které jste dostali. Hranice platí včetně, stejný záznam se proto může vrátit znovu – ukládejte ho podleid. - Úprava, vystavení, úhrada i smazání dokladu mění jeho
updated_at.
Souběžné změny
Detail záznamu i odpověď na jeho změnu nesou hlavičku ETag. Pošlete ji při další změně v If-Match: když záznam mezitím změnil někdo jiný, API vrátí 412, nic neprovede a v hlavičce ETag pošle aktuální verzi. Bez If-Match se změna provede vždy.
ETAG=$(curl -s -o /dev/null -D - "https://api.fakturanet.cz/v1/invoices/123" \
-H "Authorization: Bearer $FAKTURANET_API_KEY" | tr -d '\r' | awk 'tolower($1)=="etag:" {print $2}')
curl -X PATCH "https://api.fakturanet.cz/v1/invoices/123" \
-H "Authorization: Bearer $FAKTURANET_API_KEY" \
-H "If-Match: $ETAG" \
-H "Content-Type: application/json" \
--data-raw '{"note": "Upraveno po kontrole."}'
Při opakovaném čtení pošlete ETag v If-None-Match. Když se záznam nezměnil, API vrátí 304 bez těla. Hodí se to například pro čekání na hotový export.