Przejdź do treści

Strona może być nieaktualna

Nikt jej nie zmieniał od 21 miesięcy (ostatni commit: 2025-01-22, kamil_szulc). Jeśli opisuje stan, którego już nie ma, zgłoś ją jako nieaktualną.

Ports

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

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

Widoczność i obligatorynjność pól sterowana jest ustawieniami w ustawieniach aukcji (AuctionSetting#showPorts , AuctionSetting#requirePorts) Auction settings ports

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"}}

Ostatnia zmiana: 2025-01-22 · kamil_szulc
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e