## Operatorzy

Aplikacja w module aukcji obsługuje operatorów morskich (armatorów) i lotniczych. Po wybraniu odpowiednich ustawień, w formularzu dodawania oferty powinniśmy mieć do wyboru operatora. Typ operatora zależy od ustawień typu transportu.

![Offer form operator select](<https://docs.logintegra.com/apollo-backend/static/Transports/auctions/operator-offer-form.png>)

### Ustawienia

Typ portu zależy od ustawień typu transportu(`TransportType#seaTransports` / `TransportType#airTransports`). Typ transportu może obsługiwać tylko jeden rodzaj zleceń.

![Transport type settings](<https://docs.logintegra.com/apollo-backend/static/Transports/auctions/transport-type-air-sea-transports.png>)

Widoczność i obligatorynjność pól sterowana jest ustawieniami w ustawieniach aukcji (`AuctionSetting#showOperator` , `AuctionSetting#requireOperator`) ![Auction settings operator](<https://docs.logintegra.com/apollo-backend/static/Transports/auctions/auction-setting-operator.png>)

### Obsługa przez PublicAPI

Do obsługi wymagane jest konto z poziomem dostępu super admin. Pobieranie listy operatorów:

```
GET /api/operators
GET /api/operators?type=AIR
GET /api/operators?type=SEA
```

np.:

```
szu@szumint:~/dev/json$ curl -X GET http://localhost:8080/apollo/api/operators -H "Authorization: Bearer $TOKEN"
{
  "operators": [
    {
      "id": 381076020,
      "name": "lotniczy",
      "shortName": "lot",
      "type": "AIR"
    },
    {
      "id": 381076284,
      "name": "Luftwaffe",
      "shortName": "LW",
      "type": "AIR"
    },
    {
      "id": 381076021,
      "name": "morski",
      "shortName": "mor",
      "type": "SEA"
    }
  ]
}
```

Dodawanie operatora: `POST /api/operators`

np.:

```
szu@szumint:~/dev/json$ cat air-operator.json 
{
    "type": "AIR",
    "name": "Luftwaffe",
    "shortName": "LW"
}

szu@szumint:~/dev/json$ curl -s -X POST http://localhost:8080/apollo/api/operators -H "ApiVersion: v1" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d @air-operator.json 
{"id":381078415,"name":"Luftwaffe","shortName":"LW","type":"AIR"
```

Usuwanie operatora: `DELETE /api/operators/$id`

np.:

```
szu@szumint:~/dev/json$ curl -v -X DELETE http://localhost:8080/apollo/api/operators/381076020 -H "Authorization: Bearer $TOKEN"
*   Trying 127.0.0.1:8080...
* TCP_NODELAY set
* Connected to localhost (127.0.0.1) port 8080 (#0)
> DELETE /apollo/api/operators/381076020 HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/7.68.0
> Accept: */*
> Authorization: Bearer 4t3s4a17lhjgrgrjj7n149si4mk0bko8
> 
* Mark bundle as not supporting multiuse
< HTTP/1.1 204 
< Vary: Origin
< Vary: Access-Control-Request-Method
< Vary: Access-Control-Request-Headers
< Content-Type: application/json;charset=UTF-8
< Date: Wed, 22 Jan 2025 09:42:30 GMT
< 
* Connection #0 to host localhost left intact
```

Edycja operatora: `PUT /api/operators/$id`

np.:

```
szu@szumint:~/dev/json$ cat air-operator.json 
{
    "type": "AIR",
    "name": "Luftwaffe - EDIT",
    "shortName": "LW"
}

szu@szumint:~/dev/json$ curl -s -X PUT http://localhost:8080/apollo/api/operators/381076284 -H "ApiVersion: v1" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d @air-operator.json
{"id":381076284,"name":"Luftwaffe - EDIT","shortName":"LW","type":"AIR"}
```
