Informacje

Uwierzytelnianie	wymagane
Format odpowiedzi	json
Metoda HTTP	POST

POST tickets

Ostatnia modyfikacja 1970-01-02 01:00:00

Dodanie zgłoszenia.

URL

https://your-system-name.thulium.com/api/tickets

Parametry

to wymagany	Adres e-mail odbiorcy (zgodnie ze zdefiniowaną w systemie skrzynką).
from opcjonalny	Adres e-mail autora zgłoszenia.
subject wymagany	Temat zgłoszenia.
body wymagany	Treść zgłoszenia.
body_type opcjonalny	Typ wiadomości zgłoszenia. Domyślna wartość: PLAIN. Przykładowa wartość: `HTML\|PLAIN`
comment opcjonalny	Komentarz zgłoszenia.
cc opcjonalny	Tablica adresów kopii.
attachments opcjonalny	Tablica tokenów zwróconych przez zasób pliki tymczasowe.
source opcjonalny	Źródło dodawanego zgłoszenia. Domyślna wartość: email. Przykładowa wartość: `email\|phone\|sms\|chat\|www`
direction opcjonalny	Kierunek dodawanego zgłoszenia. Możliwe wartości: w imieniu klienta (in_behalf_of) i wychodzący e-mail do klienta (out). Domyślna wartość: in_behalf_of. Przykładowa wartość: `in_behalf_of\|out`
user_login opcjonalny	Login przypisanego użytkownika. Przykładowa wartość: `akowalski`
customer_id opcjonalny	Identyfikator klienta z CRM. Przykładowa wartość: `32122`
tags opcjonalny	Tagi Przykładowa wartość: `"tags":["tag1", "tag2", "tag3"]`
status_id opcjonalny	Identyfikator statusu zgłoszenia zwrócony przez zasób statusy
substatus_id opcjonalny	Identyfikator podstatusu zgłoszenia zwrócony przez zasób statusy
category_id opcjonalny	Identyfikator kategorii zgłoszenia zwrócony przez zasób kategorie
ticket_queue_id opcjonalny	Identyfikator kolejki zgłoszeń. Jeśli nie jest podany, to kolejka jest wybierana na podstawie skrzynki odbiorczej.
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"}`

Przykładowy request

POST	`https://your-system-name.thulium.com/api/tickets`
Dane	`{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}`

Przykładowy response

{
    ticket_id: 1232
}

Przykładowe wywołanie

PHP

<?php
$data = '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}';

$request = curl_init('https://your-system-name.thulium.com/api/tickets');
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, 'POST');
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.post("https://your-system-name.thulium.com/api/tickets", "{\"to\":\"mailbox@foo.bar\",\"subject\":\"ticket subject\",\"from\":\"john.doe@foo.bar\",\"body\":\"email content\",\"comment\":\"ticket comment\",\"attachments\":[\"61527075253ba62a76ca5c\"],\"cc\":[\"cc_mail1@foo.bar\",\"cc_mail2@foo.bar\"]}");
        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 POST -H "Content-type: application/json" -d '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}' "https://your-system-name.thulium.com/api/tickets"

HTTPie

echo '{"to":"mailbox@foo.bar","subject":"ticket subject","from":"john.doe@foo.bar","body":"email content","comment":"ticket comment","attachments":["61527075253ba62a76ca5c"],"cc":["cc_mail1@foo.bar","cc_mail2@foo.bar"]}' | http -a api_user:api_pass POST https://your-system-name.thulium.com/api/tickets