Első lépések
Alap-URL
Szekció neve “Alap-URL”https://api.uptools.io/v1/trustorderAz oldalakon minden útvonal ehhez képest értendő. A kérések és a válaszok JSON-ok (Content-Type: application/json).
API-kulcs
Szekció neve “API-kulcs”- Lépj be az upTools Console-ba, és a Termékek között kapcsold be a TrustOrdert. Ingyenes.
- A Webshopok és API-kulcsok fülön add hozzá a webshopodat (csak a gépnév, például
pelda.hu). - 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:
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
Szekció neve “Az első kérés”Ellenőrizd, hogy a kulcs működik, és melyik webshophoz tartozik:
curl https://api.uptools.io/v1/trustorder/me \ -H "Authorization: Bearer $TRUSTORDER_KEY"{ "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
Szekció neve “A bekötés három hívásban”- Rendelés előtt: hash-eld a vásárló azonosítóit (hash-elés), és kérj javaslatot a
POST /check-kel (ellenőrzés). - Kézbesítés után: jelezd vissza a rendelés kimenetelét a
PUT /signals/{order_ref}-fel (visszajelzések). - Ha a rendelés visszakerül: vond vissza a jelzést a
DELETE /signals/{order_ref}-fel.
Hiba esetén átenged
Szekció neve “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.