Generate your own client

Our OpenAPI spec lives at docs.efakturuj.sk/openapi.json and is the same spec that powers the API reference and our official Dart SDK. You can generate a typed client for almost any language with openapi-generator-cli — no special tooling on our side required.

Quick command

We test against openapi-generator-cli v7.10.0. The Docker image is the easiest way to run it without a local Java install:

docker run --rm -v "$PWD:/local" \
  openapitools/openapi-generator-cli:v7.10.0 generate \
  -i https://docs.efakturuj.sk/openapi.json \
  -g <generator> \
  -o /local/efakturuj-client

Replace <generator> with one of the IDs below.

Recommended generators

• Python — -g python (uses urllib3; pair with --additional-properties=library=asyncio for an async client).
• Node / TypeScript — -g typescript-fetch for browser/Edge runtimes, -g typescript-axios for Node with retry interceptors.
• PHP — -g php (uses Guzzle); pin a PSR-4 namespace with --additional-properties=invokerPackage=Efakturuj\\Api.
• Java — -g java with --additional-properties=library=okhttp-gson for the most common stack, or library=jersey3 for Jakarta EE 9+.
• .NET / C# — -g csharp (defaults to RestSharp; switch to HttpClient with --additional-properties=library=httpclient).
• Go — -g go (uses the stdlib net/http).
• Ruby — -g ruby (Faraday-based).
• Dart — use our official package or the -g dart-dio generator. The vanilla -g dart generator currently has trouble with the oneOf / anyOf schemas Pydantic emits for our Decimal fields (it serialises them as anyOf [number, string] to keep precision) — dart-dio handles them cleanly.

Configure the client

Once generated, point the client at the production base URL and inject your API key as the X-Api-Key header (or a JWT bearer token via Authorization: Bearer ... for end-user-facing apps):

base_url = "https://api.efakturuj.sk/api/v1"
api_key  = "<YOUR_API_KEY>"   # send as X-Api-Key header
# sandbox: https://sandbox.efakturuj.sk/api/v1

Versioning & regeneration

Method names follow the <tag>Action() pattern (e.g. invoicesList, customersCreate, invoicesSend) — they are stable across minor releases. We publish the spec at the same URL and bump the info.version on every release; subscribe to the changelog to know when to regenerate.

If you hit a generator-specific quirk that's blocking you, support@efakturuj.sk — we'd rather fix the spec than have you fight the generator.