# With shell, you can just pass the correct header with each request
curl -X POST "https://api.telqtele.com/v3/client/token"
    -H "accept: application/json"
    -H "Content-Type: application/json" -d "{ \"appId\": 000001, \"appKey\": \"keykeykeykey\"}"
# Make sure to replace `000001` with your appId and `keykeykeykey` with your appKey

/*
    With our Java SDK you simply need to initialise
    TelqApi with your app key and app id.
 */
TelqApi telqApi = new TelqApi("<yourAppKey>", "<yourAppId>");

from telq import TelQTelecomAPI
telq_client = TelQTelecomAPI()

test_client.authenticate(api_id="<yourAppKey>", api_key="<yourAppId>")
###
#  Make sure to pass your app key and app id in the authenticate call.
#  Furthermore, keep in mind that your token will be automatically requested, but if for any reason
#  you destruct the test client, you will have to initialize it again with your app key and id.
###

use TelQ\Sdk\Api;
use TelQ\Sdk\Http\HttpException;

$appId = <APPID>;
$appKey = <APPKEY>;

$api = new Api($appId, $appKey);
try {
    // call api
} catch (HttpException $exception) {
    echo 'Handle http exception', PHP_EOL;
    echo 'Response code ', $exception->getResponse()->getStatus(), PHP_EOL;
    echo 'Response body ', $exception->getResponse()->getBody(), PHP_EOL;
}

  {
  "ttl": 86400,
  "value": "WDoskdWWDkdjsaSWWWSSsht/knEQGAE+MH+mwa9sqSD
      +ca3C9BbWvYDmSWWDDpppmdkdg6ilXwfGAfrjuBsW+ZFBpZAN1n+3
      oy40jnXLfsYYma8q2HBknEQGAE+MH0u+cxEQRxjiyN9y6lWmf75QJ
      oXmtE8cDIrFfShTcZ+kTHnp6rgjdd0ctwNimb07xyPQvOK0="
  }

  /*
  *  The code above will return an instance of TelqApi client that has been initialized.
  */

  ###
  # The code above will return an instance of TelQ API Client that has been initialized.
  ###

  /*
  The code above will return an instance of TelQTestClient that has been initialized.
  */

curl -X GET "https://api.telqtele.com/v3/client/networks"
  -H "accept: application/json"

  /*
  Keep in mind that to use TelQTestClient,
  first you need to initialise it with your app key and app id.
  */
  List<Network> networks = testClient.mt.getNetworks();

  // You can also filter the list of networks by mcc and mnc
  networks = telqApi.mt.getNetworks("631",null);
  networks = telqApi.mt.getNetworks(null,"02");
  networks = telqApi.mt.getNetworks(null, null, "01");

available_networks = test_client.get_networks()

###
# Keep in mind that to use TelQTelecomAPI,
# first you need to initialise it with your app key and app id (step above).
###

$networks = $api->getNetworks();
foreach ($networks as $network) {
    echo 'Mcc: ', $network->getMcc(), PHP_EOL;
    echo 'Country name: ', $network->getCountryName(), PHP_EOL;
    echo 'Mnc: ', $network->getMnc(), PHP_EOL;
    echo 'Provider name: ', $network->getProviderName(), PHP_EOL;
    echo 'Ported from mnc: ', $network->getPortedFromMnc() ?: 'empty', PHP_EOL;
    echo 'Ported from provider name: ', $network->getPortedFromProviderName() ?: 'empty', PHP_EOL;
    echo PHP_EOL;
}
echo 'Networks: ', count($networks), PHP_EOL;

[
  {
    "mcc": "262",
    "countryName": "Germany",
    "mnc": "02",
    "providerName": "Vodafone",
    "portedFromMnc": "07",
    "portedFromProviderName": "Provider"
  }
  {
    "mcc": "505",
    "countryName": "Australia",
    "mnc": "02",
    "providerName": "Optus"
  }
]

  /*
  This will return the list of all available networks at the current moment.
  Keep in mind, that this list updated frequently and it's not recommended to use this list to initiate tests after
  a long time has passed.
  */

###
#  This will return the list of all available networks at the current moment.
#  Keep in mind, that this list updated frequently and it's not recommended to use this list to initiate tests after
#  a long time has passed.
###

  /*
  This will return the list of all available networks at the current moment.
  Keep in mind, that this list updated frequently and it's not recommended to use this list to initiate tests after
  a long time has passed.
  */

[
    {
        "mcc": "231",
        "countryName": "Slovakia",
        "mnc": "02",
        "providerName": "Telekom",
        "portedFromMnc": null,
        "portedFromProviderName": null
    },
    {
        "mcc": "231",
        "countryName": "Slovakia",
        "mnc": "03",
        "providerName": "Swan",
        "portedFromMnc": null,
        "portedFromProviderName": null
    },
... more networks
]

{
  "destinationNetworks": [
    {
      "mcc": "208",
      "mnc": "10",
      "portedFromMnc": "20"
    }
  ]
}

curl -X POST "https://api.telqtele.com/v3/client/tests" -H "accept: */*"
  -H "Content-Type: application/json" -d "{ \"destinationNetworks\": [ { \"mcc\": \"208\",
      \"mnc\": \"10\", \"portedFromMnc\": \"20\" } ] }"

# Specify number directly ...
{
  "destinationNetworks": [
    {
    "phoneNumber":"77055626363"
    }
  ],
  "testIdTextType": "ALPHA_NUMERIC",
  "testIdTextCase": "MIXED",
  "testIdTextLength": "8",
  "maxCallbackRetries": 1,
  "testTimeToLiveInSeconds": 200
}

TestRequest testRequest = TestRequest.builder()
    .networks(networks)
    .build();

List<Test> requestedTests = telqApi.mt.createTests(testRequest);

destinationNetworks = [
    {
        "mcc": "206",
        "mnc": "10",
        "portedFromMnc": "20"
    },
    {
        "mcc": "716",
        "mnc": "06"
    }
]

###
# A request with only the mandatory (networks) parameter set up within the test client
# object will have this structure:
###

requested_tests = test_client.initiate_new_tests(destinationNetworks=destinationNetworks)

use TelQ\Sdk\Models\Destination;
use TelQ\Sdk\Models\Tests;

// new Destination('mcc', 'mnc', 'ported from mnc')
$sendTests = Tests::fromArray([
    'destinationNetworks' => [
        new Destination('222', '36', '10'),
        new Destination('505', '01')
    ]
]);
$tests = $api->sendTests($sendTests);
foreach ($tests as $test) {
    echo 'Id: ', $test->getId(), PHP_EOL;
    echo 'PhoneNumber: ', $test->getPhoneNumber(), PHP_EOL;
    echo 'TestIdText: ', $test->getTestIdText(), PHP_EOL;
    echo 'Error message: ', $test->getErrorMessage() ?: 'empty', PHP_EOL;
    echo 'Destination:', PHP_EOL;
    echo '    Mcc: ', $test->getDestinationNetwork()->getMcc(), PHP_EOL;
    echo '    Mnc: ', $test->getDestinationNetwork()->getMnc(), PHP_EOL;
    echo '    Ported from mnc: ', $test->getDestinationNetwork()->getPortedFromMnc() ?: 'empty', PHP_EOL;
    echo PHP_EOL;
}

{
  "destinationNetworks": [
    {
      "mcc": "206",
      "mnc": "10",
      "portedFromMnc": "20"
    },
    {
      "mcc": "716",
      "mnc": "06",
    }
  ],
  "resultsCallbackUrl": "https://some-callback-url.com/some-path",
  "testIdTextType": "ALPHA_NUMERIC",
  "testIdTextCase": "MIXED",
  "testIdTextLength": "6",
  "maxCallbackRetries": 1,
  "testTimeToLiveInSeconds": 200
}

List<Network> networks = new ArrayList<>();

  Network network_1 = Network.builder()
    .mcc("206")
    .mnc("10")
    .portedFromMnc("20")
    .build();

  Network network_2 = Network.builder()
    .mcc("716")
    .mnc("06")
    .build();

  networks.add(network_1);
  networks.add(network_2);

  int maxCallBackRetries = 1;
  String resultsCallbackUrl = "https://some-callback-url.com/some-path";
  int testTimeToLive = 200;
  String callBackToken = "peHWFdAXikjzmMgqPTwhpeHWFdAXikjzmMgqPTwhpeHWFdAXikjzmMgqPTwh";

  TestIdTextOptions testIdTextOptions = TestIdTextOptions.builder()
    .testIdTextType(TestIdTextType.ALPHA_NUMERIC)
    .testIdTextCase(TestIdTextCase.MIXED)
    .testIdTextLength(6)
    .build();

  TestRequest testRequest = TestRequest.builder()
    .networks(networks)
    .maxCallbackRetries(maxCallBackRetries)
    .callbackUrl(resultsCallbackUrl)
    .callbackToken(callBackToken)
    .testTimeToLive(testTimeToLive)
    .timeUnit(TimeUnit.MINUTES)
    .testIdTextOptions(testIdTextOptions)
    .build();

  List<Test> requestedTests = testClient.mt.createTests(testRequest);

requested_tests = test_client.initiate_new_tests(
    destinationNetworks=destinationNetworks,
    resultsCallbackUrl="https://my-callback-url.com/telq_result",
    maxCallbackRetries=3,
    testIdTextType="ALPHA_NUMERIC",
    testIdTextCase="MIXED",
    testIdTextLength=7,
    testTimeToLiveInSeconds=3000
)
requested_tests = test_client.initiate_new_tests(destinationNetworks=destinationNetworks)

$sendTests = Tests::fromArray([
    'destinationNetworks' => [
        new Destination('222', '36', '10'),
        new Destination('505', '01')
    ],
    'resultsCallbackUrl' => 'https://my-domain.com/telq-callback',
    'maxCallbackRetries' => 3,
    'testIdTextType' => 'ALPHA',
    'testIdTextCase' => 'MIXED',
    'testIdTextLength' => 6,
    'testTimeToLiveInSeconds' => 3600
]);

[
  {
    "id": 894562,
    "phoneNumber": "33611223344",
    "testIdText": "zlrtyrvdl",
    "errorMessage": "null",
    "destinationNetwork": {
      "mcc": "206",
      "mnc": "10",
      "portedFromMnc": "20"
    }
  }
]

###
#  This test initiation returns a List of Tests, test response consists of data describing a single test
#  initialized. Careful not to lose your test id. Otherwise you won't be able to retrieve test results from our API.
###

  /*
  This test initiation returns a List of Tests, test response consists of data describing a single test
  initialized. Careful not to lose your test id. Otherwise you won't be able to retrieve test results from our API.
  */

[
  {
    "id": 894562,
    "phoneNumber": "33611223344",
    "testIdText": "zlrtyrvdl",
    "errorMessage": "null",
    "destinationNetwork": {
      "mcc": "206",
      "mnc": "10",
      "portedFromMnc": "20"
    }
  },
  {
    "id": 894563,
    "phoneNumber": null,
    "testIdText": null,
    "errorMessage": "NETWORK_OFFLINE",
    "destinationNetwork": {
      "mcc": "716",
      "mnc": "06",
    }
  }
]

# or ...
[
  {
      "id": 123399,
      "testIdText": "365450",
      "phoneNumber": "77055626363",
      "errorMessage": null,
      "destinationNetwork": {
          "mcc": "722",
          "mnc": "070",
          "portedFromMnc": null
      }
  }
]

  /*
  This returns a list of all tests that have been initialized. They contain some basic data, and the most important
  parameter, test id. You need the test it to request test results.
  */
  List<Test> requestedTests = testClient.mt.createTests(testRequest);
  /*
  You can get the test id this way. (For example)
   */
  Long testId = requestedTests.get(0).getId();

###
# Each test initiation returns a JSON response, containing the test details.
# Most importantly, it contains the phoneNumber, testIdText, and id.
# You will need the (test) id to request the test results.
###

###
# You can get the test id (of the first test) this way:
###

test_id = requested_tests[0].get('id')

// You can get the test result (of the test with id 13777294) this way:
$result = $api->getTestResult(13777294);
echo 'Id: ', $result->getId(), PHP_EOL;

curl -X GET "https://api.telqtele.com/v3/client/tests?from=2023-09-13T12:47:00Z&to=2023-10-13T12:47:00Z&page=1&size=10&order=asc"
  -H "accept: */*"

  /*
  Getting your test result would look like this. Presuming that testId is a variable of type Long
  that contains a test id.
   */
  MtApiTestResultDto result = testClient.mt.getTestById(testId);

  // Get a page of test results
    PageConf pageConf = PageConf.builder()
        .page(1)
        .size(10)
        .build();
    Instant from = Instant.parse("2023-09-13T12:47:00Z");
    Instant to = Instant.parse("2023-10-13T12:47:00Z");
    Page<MtApiTestResultDto> page = telqApi.mt.getTestPage(pageConf, from, to);

###
# Getting your test result would look like this:
###

test_result = test_client.get_test_results(test_id)

$result = $api->getTestResult(13777294);
echo 'Id: ', $result->getId(), PHP_EOL;
echo 'TestIdText: ', $result->getTestIdText(), PHP_EOL;
echo 'Sender delivered: ', $result->getSenderDelivered() ?: 'empty', PHP_EOL;
echo 'Text delivered: ', $result->getTextDelivered() ?: 'empty', PHP_EOL;
echo 'Test created: ', $result->getTestCreatedAt()->format('Y-m-d H:i:s'), PHP_EOL; // return DateTime https://www.php.net/manual/en/class.datetime.php
echo 'Sms received: ', $result->getSmsReceivedAt() ? $result->getSmsReceivedAt()->format('Y-m-d H:i:s'): 'empty', PHP_EOL;
echo 'Receipt delay: ', $result->getReceiptDelay() ?: 'empty', PHP_EOL;
echo 'Test status: ', $result->getTestStatus(), PHP_EOL;
echo 'Network:', PHP_EOL;
if ($result->getDestinationNetworkDetails()) {
    echo '    Mcc: ', $result->getDestinationNetworkDetails()->getMcc(), PHP_EOL;
    echo '    Country name: ', $result->getDestinationNetworkDetails()->getCountryName(), PHP_EOL;
    echo '    Mnc: ', $result->getDestinationNetworkDetails()->getMnc(), PHP_EOL;
    echo '    Provider name: ', $result->getDestinationNetworkDetails()->getProviderName(), PHP_EOL;
    echo '    Ported from mnc: ', $result->getDestinationNetworkDetails()->getPortedFromMnc() ?: 'empty', PHP_EOL;
    echo '    Ported from provider name: ', $result->getDestinationNetworkDetails()->getPortedFromProviderName() ?: 'empty', PHP_EOL;
} else {
    echo '    empty', PHP_EOL;
}
echo 'Smsc info:', PHP_EOL;
if ($result->getSmscInfo()) {
    echo '    Smsc number: ', $result->getSmscInfo()->getSmscNumber() ?: 'empty', PHP_EOL;
    echo '    Country name: ', $result->getSmscInfo()->getCountryName() ?: 'empty', PHP_EOL;
    echo '    Country code: ', $result->getSmscInfo()->getCountryCode() ?: 'empty', PHP_EOL;
    echo '    Mcc: ', $result->getSmscInfo()->getMcc() ?: 'empty', PHP_EOL;
    echo '    Mnc: ', $result->getSmscInfo()->getMnc() ?: 'empty', PHP_EOL;
    echo '    Provider name: ', $result->getSmscInfo()->getProviderName() ?: 'empty', PHP_EOL;
} else {
    echo '    empty', PHP_EOL;
}
echo 'Pdu delivered: ', $result->getPdusDelivered() ? implode(', ', $result->getPdusDelivered()) : 'empty', PHP_EOL;

{
    "id": 120970,
    "testIdText": "fEgMxrKAEk",
    "senderDelivered": null,
    "textDelivered": null,
    "testCreatedAt": "2023-10-26T10:49:42.442454Z",
    "smsReceivedAt": null,
    "receiptDelay": null,
    "receiptStatus": "WAIT",
    "destinationNetworkDetails": {
        "mcc": "289",
        "mnc": "88",
        "portedFromMnc": null,
        "countryName": "Abkhazia",
        "providerName": "A-Mobile",
        "portedFromProviderName": null,
        "phone": "79407295193"
    },
    "smscInfo": {
        "smscNumber": "79407777793",
        "countryName": null,
        "countryCode": null,
        "mcc": null,
        "mnc": null,
        "providerName": null
    },
    "pdusDelivered": null
}

curl -X GET "https://api.telqtele.com/v3/client/tests/23"
  -H "accept: */*"

curl -X POST "https://api.telqtele.com/v3/client/sessions" \
-H "Content-Type: application/json" \
-d '{
    "hostIp": "123.231.12.123",
    "hostPort": 2775,
    "systemId": "my_session",
    "password": "Pghks46i",
    "systemType": null,
    "throughput": 5,
    "destinationTon": 1,
    "destinationNpi": 1,
    "enabled": true,
    "windowSize": 1,
    "useSSL": false,
    "windowWaitTimeout": 60000
}'

LntApiCreateOrUpdateSessionDto sessionDto = LntApiCreateOrUpdateSessionDto.builder()
   .destinationNpi((byte) 0x01)
   .destinationTon((byte) 0x00)
   .hostIp("testing.test")
   .systemId("systemId")
   .throughput(10)
   .hostPort(123)
   .systemType("123")
   .useSSL(true)
   .windowSize(10)
   .password("password")
   .build();
LntApiSessionCreationResponseDto session = telqApi.lnt.createSession(sessionDto);

{ 
    "smppSessionId": 15388,
    "hostIp": "123.231.12.123",
    "hostPort": 2775,
    "systemId": "my_session",
    "systemType": null,
    "enabled": true
}

curl -X PUT "https://api.telqtele.com/v3/client/sessions" \
-H "Content-Type: application/json" \
-d '{
    "smppSessionId": 15412,
    "hostIp": "123.172.12.123",
    "hostPort": 2775,
    "systemId": "my_session_1",
    "password": "fh34ryQd",
    "systemType": null,
    "throughput": 7,
    "destinationTon": 1,
    "destinationNpi": 1,
    "enabled": true,
    "windowSize": 1,
    "windowWaitTimeout": 60000,
    "useSSL": false
}'

LntApiCreateOrUpdateSessionDto sessionDto = LntApiCreateOrUpdateSessionDto.builder()
   .smppSessionId(15412)
   .destinationNpi((byte) 0x01)
   .destinationTon((byte) 0x00)
   .hostIp("testing.test")
   .systemId("systemId")
   .throughput(10)
   .hostPort(123)
   .systemType("123")
   .useSSL(true)
   .windowSize(10)
   .password("password")
   .systemId("sysId")
   .enabled(false)
   .windowWaitTimeout(10_000L)
   .build();
telqApi.lnt.updateSession(sessionDto);

curl -X DELETE "https://api.telqtele.com/v3/client/sessions/15412" \
-H "Content-Type: application/json"

telqApi.lnt.deleteSessionById(15412);

curl -X GET "https://api.telqtele.com/v3/client/sessions/15388" \
-H "Content-Type: application/json"

LntApiSessionDto sessionWithUserDto = telqApi.lnt.getSessionById(15388L);

{
   "smppSessionId": 15388,
   "hostIp": "123.321.12.123",
   "hostPort": 2775,
   "systemId": "my_session",
   "systemType": null,
   "throughput": 5,
   "destinationTon": 1,
   "destinationNpi": 1,
   "enabled": true,
   "userId": 1,
   "userName": "userName",
   "online": false,
   "lastError": "Unable to connect to host [123.123.123.123] and port [123] within 10000 ms",
   "windowSize": 1,
   "useSSL": false,
   "windowWaitTimeout": 60000,
   "supplierCount": 2
}

curl -X GET "https://api.telqtele.com/v3/client/sessions?page=0&size=25" \
-H "Content-Type: application/json"

PageConf pageConf = PageConf.builder()
  .page(0)
  .size(20)
  .build();
Page<LntApiSessionDto> sessions = telqApi.lnt.getSessions(pageConf);

{
    "content": [
        {
            "smppSessionId": 15415,
            "hostIp": "122.23.243.12",
            "hostPort": 2775,
            "systemId": "session_132",
            "systemType": null,
            "throughput": 5,
            "destinationTon": 1,
            "destinationNpi": 1,
            "enabled": true,
            "userId": 1,
            "online": true,
            "lastError": null,
            "windowSize": 1,
            "useSSL": null,
            "windowWaitTimeout": 60000,
            "supplierCount": 1
        },
        {
            "smppSessionId": 15414,
            "hostIp": "122.23.243.15",
            "hostPort": 2775,
            "systemId": "session_131",
            "systemType": null,
            "throughput": 5,
            "destinationTon": 1,
            "destinationNpi": 1,
            "enabled": true,
            "userId": 2,
            "online": false,
            "lastError": "Unable to connect to host [122.122.122.122] and port [122] within 10000 ms",
            "windowSize": 1,
            "useSSL": null,
            "windowWaitTimeout": 60000,
            "supplierCount": 1
        }
        ... (more elements)
    ],
    "pageable": {
        "sort": {
            "unsorted": false,
            "sorted": true,
            "empty": false
        },
        "offset": 0,
        "pageNumber": 0,
        "pageSize": 10,
        "paged": true,
        "unpaged": false
    },
    "totalPages": 4,
    "last": false,
    "totalElements": 35,
    "sort": {
        "unsorted": false,
        "sorted": true,
        "empty": false
    },
    "size": 10,
    "number": 0,
    "first": true,
    "numberOfElements": 10,
    "empty": false
}

curl -X POST "https://api.telqtele.com/v3/client/suppliers" \
-H "Content-Type: application/json" \
-d '{
    "smppSessionId": 15388,
    "supplierName": "My supplier",
    "routeType": "Wholesale",
    "attributeList": [
        "DOMESTIC"
    ],
    "comment": "My first supplier",
    "serviceType": null,
    "tlv": [
        {
            "tagHex": "ABCD",
            "valueHex": "AAAA"
        }
    ],
    "udh": [
        {
            "tagHex": "AB",
            "valueHex": "ABCD"
        }
    ]
}'

LntApiCreateOrUpdateSupplierDto supplierDto = LntApiCreateOrUpdateSupplierDto.builder()
     .supplierName("supplierName")
     .attributeList(Arrays.asList(RouteAttribute.DLR, RouteAttribute.SPAM))
     .comment("comment text")
     .routeType("Wholesale")
     .serviceType("434")   
     .smppSessionId(session.getSmppSessionId())
     .tlvs(Arrays.asList(LntApiTlvDto.builder().tagHex("AAAA").valueHex("BBBB").build()))
     .udhs(Arrays.asList(LntApiUdhDto.builder().tagHex("AA").valueHex("BBBB").build()))
     .build();
LntApiSupplierCreationResponseDto supplier = telqApi.lnt.createSupplier(supplierDto);

{
    "supplierId": 1403,
    "smppSessionId": 15388,
    "supplierName": "My supplier", 
    "routeType": "Wholesale",
    "attributeList": [
        "DOMESTIC"
    ],
    "comment": "My first supplier",
    "serviceType": null
}

curl -X PUT "https://api.telqtele.com/v3/client/suppliers" \
-H "Content-Type: application/json" \
-d '{
    "supplierId": 1411,
    "supplierName": "supplier-123-123",
    "routeType": "Wholesale",
    "attributeList": [
        "P2P", "INTERNATIONAL"
    ],
    "comment": "comment 123",
    "serviceType": null,
    "tlv": [
        {
            "tagHex": "BBBB",
            "valueHex": "BBBB"
        }
    ],
    "udh": [
        {
            "tagHex": "AA",
            "valueHex": "AAAA"
        }
    ]
}'

LntApiCreateOrUpdateSupplierDto supplierDto = LntApiCreateOrUpdateSupplierDto.builder()
  .supplierId(1411L)
  .supplierName("supplierName")
  .attributeList(Arrays.asList(RouteAttribute.DLR, RouteAttribute.SPAM))
  .comment("comment text")
  .routeType("Wholesale")
  .serviceType("434")
  .smppSessionId(session.getSmppSessionId())
  .tlvs(Arrays.asList(LntApiTlvDto.builder().tagHex("AAAA").valueHex("BBBB").build()))
  .udhs(Arrays.asList(LntApiUdhDto.builder().tagHex("AA").valueHex("BBBB").build()))
  .build();
telqApi.lnt.updateSupplier(supplierDto);

curl -X DELETE "https://api.telqtele.com/v3/client/supplier/1411" \
-H "Content-Type: application/json"

telqApi.lnt.deleteSupplierById(1411L);

curl -X PUT "https://api.telqtele.com/v3/client/suppliers/assign" \
-H "Content-Type: application/json" \
-d '{
    "smppSessionId" : 15388,
    "supplierIds" : [1401, 1402, 1403]
}'

Set<Long> supplierIds = new HashSet<>();
supplierIds.addAll(Arrays.asList(1401, 1402, 1403));

LntApiAssignSuppliersDto assignDto = LntApiAssignSuppliersDto.builder()
  .smppSessionId(15388)
  .supplierIds(supplierIds)
  .build()

telqApi.lnt.assignSuppliersToSession(assignDto);

curl -X GET "https://api.telqtele.com/v3/client/suppliers/1411" \
-H "Content-Type: application/json"

LntApiSupplierDto updatedSupplier = telqApi.lnt.getSupplierById(1411L);

{
   "supplierId": 1400,
   "supplierName": "Supplier 5",
   "routeType": "Wholesale",
   "attributeList": null,
   "comment": "no comment",
   "serviceType": null,
   "tlv": [],
   "udh": []
   "smppSessionId": 15405,
   "userId": 1
}  

curl -X GET "https://api.telqtele.com/v3/client/suppliers" \
-H "Content-Type: application/json"

PageConf pageConf = PageConf.builder()
  .page(0)
  .size(20)
  .build();
Page<LntApiSupplierDto> suppliers = telqApi.lnt.getSuppliers(pageConf);

{
    "content": [
        {
            "supplierId": 1425,
            "supplierName": "test-supplier-public-api1",
            "routeType": "Wholesale",
            "attributeList": [
                "DOMESTIC"
            ],
            "comment": "comment",
            "serviceType": null,
            "tlv": [],
            "udh": [],
            "smppSessionId": 10588,
            "userId": 2726
        },
        {
            "supplierId": 1424,
            "supplierName": "testSession",
            "routeType": "Wholesale",
            "attributeList": [
                "DOMESTIC"
            ],
            "comment": null,
            "serviceType": null,
            "tlv": [],
            "udh": [],
            "smppSessionId": 10588,
            "userId": 2726
        },
        {
            "supplierId": 1423,
            "supplierName": "supplier999",
            "routeType": "Wholesale",
            "attributeList": null,
            "comment": null,
            "serviceType": null,
            "tlv": null,
            "udh": null,
            "smppSessionId": null,
            "userId": 850
        },
        ... (more elements)
    ],
    "pageable": {
        "sort": {
            "unsorted": false,
            "sorted": true,
            "empty": false
        },
        "pageNumber": 0,
        "pageSize": 100,
        "offset": 0,
        "paged": true,
        "unpaged": false
    },
    "totalPages": 1,
    "last": true,
    "totalElements": 63,
    "sort": {
        "unsorted": false,
        "sorted": true,
        "empty": false
    },
    "first": true,
    "numberOfElements": 63,
    "size": 100,
    "number": 0,
    "empty": false
}

curl -X GET "https://api.telqtele.com/v3/client/sessions-suppliers?page=0&size=20" \
-H "Content-Type: application/json"

PageConf pageConf = PageConf.builder()
  .page(0)
  .size(20)
  .build();
Page<LntApiSessionsSuppliersStatusResponse> suppliersStatusResponsePage = 
  telqApi.lnt.getSessionSuppliers(pageConf);

{
    "content": [
        {
            "smppSessionId": 313,
            "supplierId": 809,
            "supplierName": "My supplier",
            "routeType": "Direct",
            "online": true,
            "attributeList": []
        },
        {
            "smppSessionId": 313,
            "supplierId": 810,
            "supplierName": "My other supplier",
            "routeType": "Wholesale",
            "online": false,
            "attributeList": []
        },
        ... (more elements)
    ],
    "pageable": {
        "sort": {
            "unsorted": false,
            "sorted": true,
            "empty": false
        },
        "pageNumber": 0,
        "pageSize": 100,
        "offset": 0,
        "paged": true,
        "unpaged": false
    },
    "totalPages": 1,
    "last": true,
    "totalElements": 63,
    "sort": {
        "unsorted": false,
        "sorted": true,
        "empty": false
    },
    "first": true,
    "numberOfElements": 63,
    "size": 100,
    "number": 0,
    "empty": false
}

curl -X POST https://api.telqtele.com/v3/client/lnt/tests \
-H "Content-Type: application/json" \
-d '{
    "tests": [
        {
            "sender": "SenderName",
            "text": "Message",
            "testIdTextType": "ALPHA",
            "testIdTextCase": "LOWER",
            "testIdTextLength": 7,
            "supplierId": 17,
            "mcc": "603",
            "mnc": "01",
            "portedFromMnc": "01"
        },
        // ...more tests
        ],
    "resultsCallbackUrl": "https://some-callback-url.com/some-path",
    "maxCallbackRetries": 2,
    "dataCoding": "01", // [00, 01, 03, 08, F0]
    "sourceTon": "02", // [00, 01, 02, 03, 04, 05, 06]
    "sourceNpi": "12", // [00, 01, 03, 04, 06, 08, 09, 0A, 0E, 12]
    "testTimeToLiveInSeconds": 600,
    "smppValidityPeriod": 120,
    "scheduledDeliveryTime": "2209131247000000", // format YYMMDDhhmmsstnnp
    "replaceIfPresentFlag": 0,
    "priorityFlag": 1,
    "sendTextAsMessagePayloadTlv": 0,
    "commentText": "Optional comment",
    "tlv": [{
        "tagHex":"1B1A", // only HEX values (2 bytes length)
        "valueHex":"1AAF" // only HEX values 
    }
    ],
    "udh":[{
        "tagHex":"1F", // only HEX values (1 byte length)
        "valueHex": "11BB" // only HEX values
    }]
}'

// single test
LntApiTestRequestDto testRequestDto = LntApiTestRequestDto.builder()
    .tests(Collections.singletonList(
  LntApiCreateTestDto.builder()
  .sender("123456789")
  .text("Hello, World!")
  .testIdTextLength(6)
  .supplierId(6L)
  .mcc("412")
  .mnc("88")
  .build()
  )).build();

// advanced options
testRequestDto = LntApiTestRequestDto.builder()
  .maxCallbackRetries(3)
  .dataCoding("01")
  .commentText("my comment")
  .priorityFlag(Byte.valueOf("1"))
  .testTimeToLiveInSeconds(360)
  .sourceNpi("02")
  .sourceTon("01")
  .smppValidityPeriod(360)
  .resultsCallbackUrl("https://example.com/callback")
  .sendTextAsMessagePayloadTlv(false)
  .scheduledDeliveryTime("2209131247000000")
  .replaceIfPresentFlag(false)
  .udh(Collections.singletonList(
    LntApiUdhDto.builder()
    .tagHex("1F")
    .valueHex("11BB")
    .build()
  ))
  .tlv(Collections.singletonList(
     LntApiTlvDto.builder()
     .tagHex("1B1A")
     .valueHex("1AAF")
     .build()
  ))
  .tests(Collections.singletonList(
    LntApiCreateTestDto.builder()
    .sender("123456789")
    .text("Hello, World!")
    .testIdTextLength(6)
    .testIdTextCase(TestIdTextCase.MIXED)
    .testIdTextType(TestIdTextType.NUMERIC)
    .portedFromMnc(null)
    .supplierId(6L)
    .mcc("412")
    .mnc("88")
    .build()
  )).build();

LntApiCreateTestResponseDto testsCreated = telqApi.lnt.createTests(testRequestDto);

// Response body
{
    "tests": [
        {
            "id": 1151236,
            "testIdText": "iFnRrJ",
            "phoneNumber": "79407295193",
            "destinationNetwork": {
                "mcc": "289",
                "mnc": "88",
                "portedFromMnc": null
            },
            "errorMessage": null
        }
    ],
    "error": null
}

curl -X GET "https://api.telqtele.com/v3/client/lnt/tests" \
-H "Content-Type: application/json"

curl -X GET "https://api.telqtele.com/v3/client/lnt/tests?page=0&size=1000&order=asc" \
-H "Content-Type: application/json"

  PageConf pageConfig = PageConf.builder()
  .page(0)
  .size(1000)
  .order(PageConf.Order.ASC)
  .build();
  Page<LntApiTestResultDto> tests = telqApi.lnt.getTestPage(pageConfig, null, null);

curl -X GET "https://api.telqtele.com/v3/client/lnt/tests?from=2023-10-18T10:14:04.038983Z&to=2023-10-20T10:14:04.038983Z&page=0&size=100&order=asc" \
-H "Content-Type: application/json"

  Page<LntApiTestResultDto> tests = telqApi.lnt.getTestPage(
  null,
  Instant.parse("2023-10-18T10:14:04.038983Z"),
  Instant.parse("2023-10-18T10:14:08.038983Z")
  );

curl -X GET "https://api.telqtele.com/v3/client/lnt/tests?size=1" \
-H "Content-Type: application/json"

{
    "content": [
        {
            "id": 1013798,
            "testIdText": "590359",
            "senderSent": "Google",
            "senderDelivered": "Google",
            "textSent": "G-{TEST_ID_TEXT} is your Google verification code.",
            "textDelivered": "G-590359 is your Google verification code.",
            "testCreatedAt": "2023-10-18T10:14:04.038983Z",
            "smppSessionId": 1,
            "supplier": {
                "supplierId": 6,
                "supplierName": "TelQ",
                "routeType": "Wholesale"
            },
            "smsReceivedAt": "2023-10-18T10:14:08.038983Z",
            "receiptStatus": "POSITIVE",
            "dlrStatus": "DELIVERED",
            "receiptDelay": 4,
            "dlrDelay": 7,
            "scheduledTaskId": null,
            "destinationNetworkDetails": {
                "mcc": "204",
                "mnc": "16",
                "portedFromMnc": null,
                "countryName": "Netherlands",
                "providerName": "T-Mobile",
                "portedFromProviderName": null,
                "phoneNumber": "31639654167",
                "manualNumber": null
            }
            "smscInfo": {
                "smscNumber": "+46707990043",
                "countryName": "Sweden",
                "countryCode": "SE",
                "mcc": "240",
                "mnc": "07",
                "providerName": "Tele2"
            },
            "retry": false,
            "pdusDelivered": [
            "0791947106004034040BD0C7F7FBCC2E0300003201622104638021B618AC76B3DD40E93928FFAECB41F6B23C6D4E8FC3F4F4DB0D1ABFC965"
            ],
            "user": {
                "id": 2837,
                "email": "telqdemo@telqtele.com",
                "username": "TelQ_Demo",
                "fullName": "TelQ Telecom"
            }
        },
        // more tests ...
    ],
    "page": 0,
    "size": 20,
    "order": "asc",
    "error": null
}

curl -X GET "https://api.telqtele.com/v3/client/lnt/tests/1155470" \
-H "Content-Type: application/json"

LntApiTestResultDto test = telqApi.lnt.getTestById(1155470L);

{
  "id": 23,
  "testIdText":"irrgprny",
  "senderDelivered":"+4944557775544",
  "textDelivered":"irrgprny fgsfgsd",
  "testCreatedAt":"2020-02-13T17:01:54.352886Z","smsReceivedAt":"2020-02-13T17:05:27Z",
  "receiptDelay":213,
  "receiptStatus":"POSITIVE",
  "destinationNetwork": {
    "mcc": "206",
    "mnc": "10",
    "portedFromMnc": "20"
  },
  "smscInfo":{
    "smscNumber":null,
    "countryName":"France",
    "countryCode":"FR",
    "mcc":null,
    "mnc":null,
    "providerName":null
    },
  "pdusDelivered":["07913348466110F3040D91945102131605F60880022032225771611165B93BBF0ECBDD7990F93C345FE764"]
}

{
    "id": 4246,
    "testIdText": "249165",
    "senderSent": "IMO",
    "senderDelivered": "IMO",
    "textSent": "{TEST_ID_TEXT} is your code",
    "textDelivered": "249165 is your code",
    "testCreatedAt": "2020-02-13T17:01:54.352886Z",
    "sessionId": 8,
    "supplier": {
        "supplierId": 17,
        "supplierName": "GT",
        "routeType": "DIRECT"
    },
    "smsReceivedAt": "2020-02-13T17:03:54.352886Z",
    "receiptStatus": "POSITIVE",
    "dlrStatus": "DELIVERED",
    "receiptDelay": 10,
    "dlrDelay": 9,
    "scheduledTaskId": null,
    "testIdTextType": "NUMERIC",
    "testIdTextCase": null,
    "testIdTextLength": 6,
    "destinationNetworkDetails": {
        "mcc": "427",
        "mnc": "01",
        "portedFromMnc": null,
        "countryName": "Qatar",
        "providerName": "Ooredoo",
        "portedFromProviderName": null,
        "phone": "97450775267",
        "manualNumber": null
    },
    "smscInfo": {
        "smscNumber": "+97477922224",
        "countryCode": "QA",
        "mcc": "427",
        "mnc": "02",
        "providerName": "Vodafone"
    },
    "retry": false,
    "pdusDelivered": [
        "07917974972222F42406D0C9E61300004220509095352113325A2E66AB81D27350FE5D9783C66F7219"
    ],
    "username": "din-din-telecom"
}

{
  "reportId": 1,  // Unique identifier for the report
  "createdAt": "2021-01-01T00:00:00Z", // ISO 8601 formatted date and time when the report was created
  "scheduledTaskId": 12345,
  "scheduledTaskTitle": "Austria&Germany", // Title of the scheduled task
  "testId": 1029746, // Identifier for the associated test
  "senderId": "Google",
  "text": "G-{TEST_ID_TEXT} is your Google verification code.",
  "phone": "50687058156",
  "sessionId": 2130,
  "supplier": {
    "supplierId": 6,
    "supplierName": "Telq", // Name of the supplier
    "routeType": "RT"  // Type of route used
  },
  "reportRule": {
    "receiptStatus": "NOT_DELIVERED", // Current status of the test (refer to the list of available test statuses)
    "receiptStatusWaitingTimeSec": 3600, // Time in seconds to wait for a test status change (range: 1-86400, here representing 1 hour)
    "dlrStatus": "UNKNOWN", // Current state of the message (refer to the list of available message states)
    "dlrStatusWaitingTimeSec": 3600 // Time in seconds to wait for a message state change (range: 1-86400, here representing 1 hour)
  },
  "receiptDelay": 6,
  "dlrDelay": 7,
  "callbackUrl": "https://tools.telqtele.com/callback-random"
}