Informacje

Uwierzytelnianie wymagane
Format odpowiedzi json
Metoda HTTP GET

GET companies/:id

Ostatnia modyfikacja 2024-11-20 13:20:36
Zwraca firmę o podanym identyfikatorze firmy.

URL

https://your-system-name.thulium.com/api/companies/:id

Parametry

id

wymagany

Identyfikator firmy. Przykładowa wartość: 28
include_custom_fields

opcjonalny

Czy zwracać pola specjalne klienta. Przykładowa wartość: true
include_address

opcjonalny

Czy zwracać adres klienta. Przykładowa wartość: true
include_invoice_address

opcjonalny

Czy zwracać adres do faktur. Przykładowa wartość: true
include_mail_drop_address

opcjonalny

Czy zwracać adres korespondencyjny. Przykładowa wartość: true

Przykładowy request

GET https://your-system-name.thulium.com/api/companies/28?include_custom_fields=true&include_address=true

Przykładowy response

{
    "name": "Thulium",
    "company_id": 28,
    "customer_id": 13,
    "type": "internal",
    "group": "partner",
    "nip": "6783144527",
    "account_manager":"",
    "address":
    {
        "street": "Zlotej Jesieni",
        "building": "7",
        "flat": null,
        "postcode": "31-827",
        "city": "Krakow",
        "post_office": "Krakow",
        "borough": null,
        "county": null,
        "voivodship": null,
        "country": "Poland"
    },
    custom_fields":
    {
      "ID": null,
      "Additional info": "none"
    }
}

Przykładowe wywołanie


PHP

<?php
$request 
curl_init('https://your-system-name.thulium.com/api/companies/28?include_custom_fields=true&include_address=true');
curl_setopt($requestCURLOPT_HTTPHEADER, array('Content-Type: application/json; charset=utf-8'));
curl_setopt($requestCURLOPT_USERPWD"api_user:api_pass");
curl_setopt($requestCURLOPT_TIMEOUT30);
curl_setopt($requestCURLOPT_RETURNTRANSFERtrue);

$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.get("https://your-system-name.thulium.com/api/companies/28?include_custom_fields=true&include_address=true");
        System.out.println(response);
    }
}

CURL

curl -u api_user:api_pass -k -X GET -H "Accept: application/json" "https://your-system-name.thulium.com/api/companies/28?include_custom_fields=true&include_address=true"

HTTPie

http -a api_user:api_pass GET https://your-system-name.thulium.com/api/companies/28 include_custom_fields==true include_address==true Accept:application/json