Základná URL
https://{tenant}.logzi.com/api/partner_address/
Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. Adresa partnera je doručovacie alebo fakturačné miesto priradené k partnerovi — partner môže mať viacero adries.
/api/partner_address/get
Získanie jednej adresy partnera podľa identifikátora, identifikátora partnera alebo kontrolného súčtu (checksum).
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Jedinečný identifikátor adresy | |
partner_id | int | Identifikátor partnera — vráti sa prvá adresa | |
checksum | string | Kontrolný súčet (checksum) adresy | |
language_id | int | Identifikátor jazyka pre preklad |
Príklad požiadavky
GET /api/partner_address/get?id=15
X-API-KEY: {vas_api_kluc}
/api/partner_address/list
Stránkovaný zoznam adries partnerov s možnosťami filtrovania.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
list_offset | int | Posun stránkovania (predvolené: 0) | |
partner_id | int | Filter podľa identifikátora partnera | |
list_condition[partner_id] | int | Filter podľa identifikátora partnera (v objekte podmienok) | |
list_condition[partner_address_status_id] | int | Filter podľa stavu adresy | |
language_id | int | Identifikátor jazyka |
Príklad požiadavky
GET /api/partner_address/list?partner_id=42&list_offset=0
X-API-KEY: {vas_api_kluc}
/api/partner_address/save
Vytvorenie alebo úprava adresy partnera. Pre novú adresu data[id] = 0.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | 0 = nová adresa, >0 = úprava | |
partner_id | int | Identifikátor partnera (povinné pri novej adrese) | |
country_id | int | Identifikátor krajiny | |
zip | string | PSČ | |
city | string | Mesto | |
address | string | Ulica, číslo domu | |
partner_address_type_id | int | Typ adresy (fakturačná, doručovacia atď.) | |
address_user_name | string | Meno kontaktnej osoby na adrese | |
address_comment | string | Poznámka k adrese | |
address_building | string | Označenie budovy | |
address_door | string | Dvere | |
address_floor | string | Poschodie | |
address_number | string | Číslo dverí / bytu | |
address_stairwell | string | Schodisko | |
district | string | Mestská časť (bez bodky, napr. „XIV“) | |
partner_address_status_id | int | Identifikátor stavu adresy | |
outer_resource_id | string | Identifikátor v externom systéme |
Príklad požiadavky
POST /api/partner_address/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{
"data": {
"id": 0,
"partner_id": 42,
"country_id": 1,
"zip": "1051",
"city": "Budapest",
"address": "Nádor utca 10.",
"partner_address_type_id": 1,
"address_user_name": "Raktáros",
"district": "V"
}
}
/api/partner_address/delete
Odstránenie adresy partnera podľa identifikátora.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor adresy, ktorá sa má odstrániť |
Príklad požiadavky
POST /api/partner_address/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 15 } }
Zaregistruj sa teraz,
zaplať neskôr!