Informacje

Uwierzytelnianie wymagane
Format odpowiedzi json
Metoda HTTP PUT

PUT batch/customers

Ostatnia modyfikacja 2020-08-28 14:13:17

Edycja wielu klientów.

URL

https://api.thulium.pl/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.
          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.

Przykładowy request

PUT https://api.thulium.pl/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.pl/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.pl/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.pl/api/batch/customers"