hypernode-api-php/src/Service/App.php at 777621d6639f1d22a71d19d9fe7eecafbb6c9840 · ByteInternet/hypernode-api-php · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
<?php

declare(strict_types=1);

namespace Hypernode\Api\Service;

class App extends AbstractService
{
    public const V2_APP_LIST_URL = "/v2/app/";
    public const V2_APP_DETAIL_URL = "/v2/app/%s/";
    public const V2_APP_CANCEL_URL = "/v2/app/%s/cancel/";
    public const V2_BRANCHER_APP_URL = "/v2/brancher/app/%s/";
    public const V2_BRANCHER_DETAIL_URL = "/v2/brancher/%s/";
    public const V1_APP_FLOWS_URL = "/logbook/v1/logbooks/%s/flows/";
    public const V2_APP_BLOCK_ATTACK_DESCRIPTIONS_URL = "/v2/app/block_attack_descriptions/";
    public const V2_APP_EAV_DESCRIPTIONS_URL = "/v2/app/eav_descriptions/";
    public const V2_APP_ORDER_URL = "/v2/app/order/";

    /**
     * @param array $params
     * @return \Hypernode\Api\Resource\App[]
     * @throws \Http\Client\Exception
     * @throws \Hypernode\Api\Exception\HypernodeApiClientException
     * @throws \Hypernode\Api\Exception\HypernodeApiServerException
     */
    public function getList(array $params = []): array
    {
        $apps = [];

        $requestUrl = self::V2_APP_LIST_URL;
        if ($params) {
            $requestUrl .= '?' . http_build_query($params);
        }

        while ($requestUrl) {
            $response = $this->client->api->get($requestUrl);

            $this->client->maybeThrowApiExceptions($response);
            $data = $this->client->getJsonFromResponse($response);

            foreach ($data['results'] as $item) {
                $apps[] = new \Hypernode\Api\Resource\App($this->client, $item);
            }

            $requestUrl = $data['next'];
        }

        return $apps;
    }

    /**
     * Show the available blocks that can be triggered using the block attack endpoint.
     *
     * @return array Map of attack names to their descriptions
     * @throws \Http\Client\Exception
     * @throws \Hypernode\Api\Exception\HypernodeApiClientException
     * @throws \Hypernode\Api\Exception\HypernodeApiServerException
     */
    public function getBlockAttackDescriptions(): array
    {
        $response = $this->client->api->get(self::V2_APP_BLOCK_ATTACK_DESCRIPTIONS_URL);

        $this->client->maybeThrowApiExceptions($response);

        return $this->client->getJsonFromResponse($response);
    }

    /**
     * Show the available EAVs (entity-attribute values) that can be changed
     * using the settings service.
     *
     * @return array Map of setting names to their descriptions
     * @throws \Http\Client\Exception
     * @throws \Hypernode\Api\Exception\HypernodeApiClientException
     * @throws \Hypernode\Api\Exception\HypernodeApiServerException
     */
    public function getEavDescriptions(): array
    {
        $response = $this->client->api->get(self::V2_APP_EAV_DESCRIPTIONS_URL);

        $this->client->maybeThrowApiExceptions($response);

        return $this->client->getJsonFromResponse($response);
    }

    /**
     * Order a new Hypernode under your account.
     *
     * @param array $data Order data, requires at least the keys
     *  `product_code`, `app_name` and `initial_app_configuration`.
     * @return void
     * @throws \Http\Client\Exception
     * @throws \Hypernode\Api\Exception\HypernodeApiClientException
     * @throws \Hypernode\Api\Exception\HypernodeApiServerException
     */
    public function order(array $data): void
    {
        $response = $this->client->api->post(self::V2_APP_ORDER_URL, [], json_encode($data));

        $this->client->maybeThrowApiExceptions($response);
    }
}