# Első lépések

> A TrustOrder REST API röviden. Alap-URL, API-kulcs, éles és teszt környezet, az első kérés, és hogyan engedj át hiba esetén.

## Alap-URL

```text
https://api.uptools.io/v1/trustorder
```

Az oldalakon minden útvonal ehhez képest értendő. A kérések és a válaszok JSON-ok (`Content-Type: application/json`).

## API-kulcs

1. Lépj be az [upTools Console](https://console.uptools.io/)-ba, és a Termékek között kapcsold be a TrustOrdert. Ingyenes.
2. A **Webshopok és API-kulcsok** fülön add hozzá a webshopodat (csak a gépnév, például `pelda.hu`).
3. Készíts kulcsot az **Új kulcs** gombbal. A Console csak egyszer mutatja meg, ezért rögtön másold ki.

A kulcs az `Authorization` fejlécben megy:

```http
Authorization: Bearer to_live_…
```

| Kulcs-előtag | Környezet | Mit lát |
|---|---|---|
| `to_live_` | éles | az összes csatlakozó bolt éles visszajelzéseit |
| `to_test_` | teszt | csak a teszt visszajelzéseket, az élestől külön |

A bekötés fejlesztése alatt teszt kulcsot használj. A teszt kulccsal küldött visszajelzések soha nem hatnak az éles javaslatokra.

## Az első kérés

Ellenőrizd, hogy a kulcs működik, és melyik webshophoz tartozik:

```bash
curl https://api.uptools.io/v1/trustorder/me \
  -H "Authorization: Bearer $TRUSTORDER_KEY"
```

```json
{
  "shop_id": 12,
  "shop_name": "Példa bolt",
  "domain": "pelda.hu",
  "env": "live",
  "account_status": "approved",
  "daily_check_quota": 50000,
  "checks_today": 132
}
```

Az új fiók `pending` állapotban indul: az ellenőrzés azonnal működik, a küldött visszajelzései tárolódnak, de csak a jóváhagyás után számítanak.

## A bekötés három hívásban

1. **Rendelés előtt:** hash-eld a vásárló azonosítóit ([hash-elés](https://docs.uptools.io/hu/trustorder/api/hashing/)), és kérj javaslatot a `POST /check`-kel ([ellenőrzés](https://docs.uptools.io/hu/trustorder/api/check/)).
2. **Kézbesítés után:** jelezd vissza a rendelés kimenetelét a `PUT /signals/{order_ref}`-fel ([visszajelzések](https://docs.uptools.io/hu/trustorder/api/signals/)).
3. **Ha a rendelés visszakerül:** vond vissza a jelzést a `DELETE /signals/{order_ref}`-fel.

## Hiba esetén átenged

A TrustOrder soha nem állíthat meg egy eladást. Minden hibát és minden 1,5 másodpercnél lassabb választ vegyél **engedélyez**-nek. Ha a szerver nem éri el az adatait, gyorsan `503`-mal válaszol, így a rövid időkorlátú kliens gyors marad.
