Harbor Gateway
  1. Lockers
Harbor Gateway
  • Harbor Gateway API
    • Harbor Gateway
    • Health & Status
      • Admin interface
      • Health check
    • Transactions
      • List all transactions
      • Create a transaction
      • Get transaction details
      • Release transaction
      • Open locker by transaction ID
    • Lockers
      • List all lockers
        GET
      • Get locker configuration
        GET
      • Get locker details
        GET
      • Update locker service state
        PATCH
      • Open locker by ID
        POST
      • Open all lockers
        POST
    • Locker Types
      • List all locker types
      • Get locker type details
    • Bank Types
      • List all bank types
      • Get bank type with associations
    • System
      • Receive heartbeat from external device
    • Schemas
      • Locker
      • LockerTypeSummary
      • TransactionResponse
      • LockerType
      • LockController
      • System
      • LockerConfig
      • LogEntry
      • OperationResponse
      • LockerOperationResponse
      • MultiStatusOperationResponse
      • BankType
      • OpenAllLockersResponse
      • BankTypeAssociation
      • Error
      • BankTypeWithAssociations
      • DeviceHeartbeatRequest
  1. Lockers

Open locker by ID

POST
/lockers/{lockerId}/open
Opens a specific locker by its ID. Physical operation with 20-second timeout per attempt, up to 3 attempts with 1-second delays (maximum total time ~62 seconds). Retries occur on network/communication errors only; hardware malfunctions are not retried. For maintenance use - does not check transaction status, outOfService, or operational status (optimistic opening - useful for troubleshooting/maintenance).

Request

Path Params

Responses

🟢200
application/json
Locker opened successfully
Body

🟠404
🔴500
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/lockers//open'
Response Response Example
200 - Example 1
{
    "success": true,
    "lockerId": 0,
    "doorOpen": true,
    "message": "string"
}
Modified at 2026-02-20 22:56:40
Previous
Update locker service state
Next
Open all lockers
Built with