## Porty

Aplikacja w module aukcji obsługuje porty morskie i lotnicze. Po wybraniu odpowiednich ustawień, w formularzu dodawania oferty powinniśmy mieć do wyboru port załadunkowy i rozładunkowy. Typ portu zależy od ustawień typu transportu.

![Offer form port select](<https://docs.logintegra.com/apollo-backend/static/Transports/auctions/port-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-air-sea-transports ![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#showPorts` , `AuctionSetting#requirePorts`) ![Auction settings ports](<https://docs.logintegra.com/apollo-backend/static/Transports/auctions/auction-setting-ports.png>)

### Obsługa przez PublicAPI

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

```
GET /api/ports
GET /api/ports?portType=AIR
GET /api/ports?portType=SEA
```

np.:

```
curl -X GET http://localhost:8080/apollo/api/ports -H "Authorization: Bearer $TOKEN"
{
  "ports": [
    {
      "city": "Gdańsk",
      "code": "GDN",
      "country": "PL",
      "id": 381062095,
      "name": "Gdańsk Lech Wałęsa Airport",
      "portType": "AIR"
    },
    {
      "city": "Wallis",
      "code": "WLS",
      "country": "WF",
      "id": 381062104,
      "name": "Hihifo Airport",
      "portType": "AIR"
    }
  ]
}
```

Dodawanie portu: `POST /api/ports`

np.:

```
szu@szumint:~/dev/json$ cat air-port.json 
{
    "portType": "AIR",
    "country": "pl",
    "city": "Gdańsk",
    "name": "Gdańsk Lech Wałęsa Airport",
    "code": "GDN"
}
szu@szumint:~/dev/json$ curl -s -X POST http://localhost:8080/apollo/api/ports -H "ApiVersion: v1" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d @air-port.json 
{"port":{"city":"Gdańsk","code":"GDN","country":"PL","id":381078407,"name":"Gdańsk Lech Wałęsa Airport","portType":"AIR"}}
```

Usuwanie portu: `DELETE /api/ports/$id`

np.:

```
szu@szumint:~/dev/json$ curl -v -X DELETE http://localhost:8080/apollo/api/ports/381078407 -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/ports/381078407 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:33:20 GMT
< 
* Connection #0 to host localhost left intact
```

Edycja portu: `PUT /api/ports/$id`

np.:

```
szu@szumint:~/dev/json$ cat air-port.json 
{
    "portType": "AIR",
    "country": "pl",
    "city": "Gdańsk",
    "name": "Gdańsk Lech Wałęsa Airport - EDIT",
    "code": "GDN"
}
szu@szumint:~/dev/json$ curl -s -X PUT http://localhost:8080/apollo/api/ports/381078407 -H "ApiVersion: v1" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d @air-port.json 
{"port":{"city":"Gdańsk","code":"GDN","country":"PL","id":381078407,"name":"Gdańsk Lech Wałęsa Airport - EDIT","portType":"AIR"}}
```
