Informacje

Uwierzytelnianie	wymagane
Format odpowiedzi	json
Metoda HTTP	PUT

PUT batch/customers

Ostatnia modyfikacja 2026-05-18 13:56:05

Edycja wielu klientów.

URL

https://your-system-name.thulium.com/api/batch/customers

Parametry

customers wymagany	Lista klientów do edycji. Każdy klient zawiera:
customer_id wymagany	Identyfikator klienta który ma zostań zaktualizowany.
name opcjonalny	Imię klienta.
surname opcjonalny	Nazwisko klienta.
email opcjonalny	Adres lub adresy e-mail klienta.
phone_number opcjonalny	Numer lub numery telefonu firmy.
company_id opcjonalny	Identyfikator firmy, do której ma być dodany klient.
type opcjonalny	Tekstowa nazwa typu klienta zdefiniowana w systemie.
group opcjonalny	Tekstowa nazwa grupy klienta zdefiniowana w systemie.
identifier opcjonalny	Identyfikator klienta.
gender opcjonalny	Płeć klienta.
homepage opcjonalny	Strona WWW klienta.
birthdate opcjonalny	Data urodzenia klienta.
nip opcjonalny	NIP klienta.
note opcjonalny	Notatka.
pesel opcjonalny	Numer PESEL.
job opcjonalny	Miejsce pracy.
job_title opcjonalny	Stanowisko.
account_manager opcjonalny	Login opiekuna klienta
custom_fields opcjonalny	Obiekt z wartościami pól specjalnych. Przykładowa wartość: `"custom_fields":{"field_name_1":"value_1","field_name_2":"value_2"}`
fill_read_only_custom_fields opcjonalny	Flaga definiująca czy pola specjalne zostaną wypełnione pomimo posiadania typu READ ONLY. Przykładowa wartość: `true`
vip opcjonalny	VIP Przykładowa wartość: `true`
address opcjonalny	Adres klienta.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.
invoice_address opcjonalny	Adres do faktur.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.
mail_drop_address opcjonalny	Adres korespondencyjny.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.

Przykładowy request

PUT	`https://your-system-name.thulium.com/api/batch/customers`
Dane	`{ "customers": [ { "customer_id": "13", "surname": "Kowalski" }, { "customer_id": "14", "phone_number": "333444555" } ] }`

Przykładowy response

{
    "13": {
        "http_status": 204
    },
    "14": {
        "http_status": 404,
        "message": "Customer not found."
    }
}

Przykładowe wywołanie

PHP

<?php
$data = '{
    "customers": [
        {
            "customer_id": "13",
            "surname": "Kowalski"
        },
        {
            "customer_id": "14",
            "phone_number": "333444555"
        }
    ]
}';

$request = curl_init('https://your-system-name.thulium.com/api/batch/customers');
curl_setopt($request, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json; charset=utf-8',
    'Content-Length: ' . mb_strlen($data)
));
curl_setopt($request, CURLOPT_USERPWD, 'api_user:api_pass');
curl_setopt($request, CURLOPT_TIMEOUT, 30);
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($request, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($request);
if ($response) {
    $httpCode = curl_getinfo($request, CURLINFO_HTTP_CODE);
    if ($httpCode == 200){
        print_r(json_decode($response));
    } else {
        echo $response;
    }
} else {
    trigger_error(curl_error($request), E_USER_WARNING);
}

curl_close($request);

JAVA

public class Example {
    public static void main(String[] args) throws Exception {
        ThuliumRestClient restClient = new ThuliumRestClient("api_user", "api_pass", true);

        ThuliumRestClient.ThuliumRestResponse response = restClient.put("https://your-system-name.thulium.com/api/batch/customers", "{
    \"customers\": [
        {
            \"customer_id\": \"13\",
            \"surname\": \"Kowalski\"
        },
        {
            \"customer_id\": \"14\",
            \"phone_number\": \"333444555\"
        }
    ]
}");
        System.out.println(response);
    }
}

ThuliumRestClient.java (Wymaga biblioteki httpclient w wersji 4.3.5, httpcore w wersji 4.3.2, commons-codec w wersji 1.9, commons-logging w wersji 1.2)

CURL

curl -u api_user:api_pass -k -X PUT -H "Content-type: application/json" -d '{
    "customers": [
        {
            "customer_id": "13",
            "surname": "Kowalski"
        },
        {
            "customer_id": "14",
            "phone_number": "333444555"
        }
    ]
}' "https://your-system-name.thulium.com/api/batch/customers"

HTTPie

echo '{
    "customers": [
        {
            "customer_id": "13",
            "surname": "Kowalski"
        },
        {
            "customer_id": "14",
            "phone_number": "333444555"
        }
    ]
}' | http -a api_user:api_pass PUT https://your-system-name.thulium.com/api/batch/customers