# Első lépések

> REST/JSON felület a számlázz.hu Számla Agent fölött. A saját számlázz.hu Agent-kulcsoddal hívod, külön API-kulcs nélkül.

REST/JSON felület a számlázz.hu Számla Agent fölött: számlák, nyugták, díjbekérők, szállítólevelek és adószám-lekérdezés. A saját számlázz.hu Agent-kulcsoddal hívod, külön API-kulcs nélkül.

## Alap URL

```text
https://api.uptools.io/szamlazz-hu/v1
```

## Hitelesítés

A `/health` és az `/openapi.json` kivételével minden végpont az `X-Szamlazz-Agent-Key` fejlécben várja a számlázz.hu Agent-kulcsodat. Fejléc helyett az `Authorization: Bearer <kulcs>` is használható.

```bash
curl https://api.uptools.io/szamlazz-hu/v1/taxpayers/$ADOSZAM \
  -H "X-Szamlazz-Agent-Key: $SZAMLAZZ_AGENT_KEY"
```

> **Csak szerveroldalon**
>
> Az Agent-kulcs valódi számlák kiállítására jogosít. Soha ne kerüljön böngészőbe vagy kliensoldali kódba: a saját szervered hívja az API-t.

## A teljes leírás

A végpontok géppel olvasható leírása OpenAPI 3.1 formátumban: [`https://api.uptools.io/szamlazz-hu/v1/openapi.json`](https://api.uptools.io/szamlazz-hu/v1/openapi.json). Böngészőben olvasható változata: [`https://api.uptools.io/szamlazz-hu/v1/docs`](https://api.uptools.io/szamlazz-hu/v1/docs).