Informacje

Uwierzytelnianie wymagane
Format odpowiedzi json
Metoda HTTP PUT

PUT batch/customers

Ostatnia modyfikacja 2021-09-09 13:16:40

Edycja wielu klientów.

URL

https://api.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"}
          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://api.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://api.thulium.com/api/batch/customers');
curl_setopt($requestCURLOPT_HTTPHEADER, array(
    
'Content-Type: application/json; charset=utf-8',
    
'Content-Length: ' mb_strlen($data)
));
curl_setopt($requestCURLOPT_USERPWD'api_user:api_pass');
curl_setopt($requestCURLOPT_TIMEOUT30);
curl_setopt($requestCURLOPT_RETURNTRANSFERtrue);
curl_setopt($requestCURLOPT_CUSTOMREQUEST'PUT');
curl_setopt($requestCURLOPT_POSTFIELDS$data);

$response curl_exec($request);
if (
$response) {
    
$httpCode curl_getinfo($requestCURLINFO_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://api.thulium.com/api/batch/customers", "{
    \"customers\": [
        {
            \"customer_id\": \"13\",
            \"surname\": \"Kowalski\"
        },
        {
            \"customer_id\": \"14\",
            \"phone_number\": \"333444555\"
        }
    ]
}");
        System.out.println(response);
    }
}

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://api.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://api.thulium.com/api/batch/customers