Service operations

GetStatus ( ) 

Returns, as a HTTP return code, the status of the service. 200 OK means that the service is working normally.

Access method: GET

Parameters:

None.

Returns:

• 200 OK if service is running normally. Anything else indicates problems.
• See HTTP Return Codes and Error Response for other HTTP return codes.

GetDcsStatus ( airportIATA : AirportIATA ) : DcsStatus

Returns a list of airlines with DCS support that should be available for this airport (as received by GetConfiguration), and the current availability of each DCS.

Access method: GET

Parameters:

• airportIATA : AirportIATA
  Indicates the airport for which DCS status is unknown.

Returns:

• 200 OK and DcsStatus.
• See HTTP Return Codes and Error Response for other HTTP return codes.

GetOperatingCarrier ( TransactionId, AirportIATA,  BagDropUnit, BagTagNumber ) : CarrierInformation

Returns carrier information (operating carrier and flight information) if the bag tag is found. This information is typically from a BSM received by the airport. It is necessary to use GetOperatingCarrier as the BagTagIssuerCode from the bag tag might not be for the actual operating carrier (i.e. a marketing flight).

Access method: GET

Parameters:

• transactionId : TransactionId
  Identifies the transaction. See Use of TransactionId.
• airportIATA : AirportIATA
  Identifies the airport where the bag drop unit is placed.
• bagDropUnit : BagDropUnit
  Identifies the actual bag drop unit.
• bagTagNumber : BagTagNumber
  The bag tag for which operating carrier information is needed.

Returns:

• 200 OK and CarrierInformation if any carrier information is found.
• 200 OK, explanatory string and CarrierInformation if no carrier information is found. BagDepartureOperatingAirlineIATA will then just be derived from the BagTagNumber (BagTagIssuerCode). Flight information will be missing. This is usually caused by no BSM being received.
• See HTTP Return Codes and Error Response for other HTTP return codes.

LocalVerifyBag ( LocalVerifyBagInput )

Verifies that the bag drop complies to local, the current airport, rules. Does not involve the operating airline's DCS.

Access method: POST

Parameters:

• LocalVerifyBagInput

Returns:

• 200 OK if the bag verifies ok locally.
• 400 Bad Request and additional explanatory text if the bag can't be verified.
• 404 Not found if the bag is unknown.
• See HTTP Return Codes and Error Response for other HTTP return codes.

BagNotify ( BagNotifyInput )

Notifies the airport about a successful bag drop, or a failed bag drop.

Access method: POST

Parameters:

• BagNotifyInput

Returns:

• 200 OK indicates that the notification was accepted without any problems.
• See HTTP Return Codes and Error Response for other HTTP return codes.

BaggageConformanceIdentify ( TransactionId, AirportIATA,  BagDropUnit, BagTagNumber ) : BaggageConformanceIdentifyResponse

To establish whether the scanned bag tag is recognized by the DCS, and return related flight and passenger information

Access method: GET

Parameters:

• transactionId : TransactionId
  Identifies the transaction. See Use of TransactionId.
• airportIATA : AirportIATA
  Identifies the airport where the bag drop unit is placed.
• bagDropUnit : BagDropUnit
  Identifies the actual bag drop unit.
• bagTagNumber : BagTagNumber
  The bag tag that is to be identified.

Returns:

• 200 OK and BaggageConformanceIdentifyResponse if the DCS recognizes the bag tag.
• 400 Bad Request and additional explanatory text if there is an error response from the DCS.
• 404 Not found
• See HTTP Return Codes and Error Response for other HTTP return codes.

BaggageConformanceVerify ( BaggageConformanceVerifyInput )

To establish whether the bag is acceptable for carriage for the given location, point in time and bag data supplied (e.g. weight and dimension). The location may dictate which verification rules will be employed. The bag will be activated as part of a verification step if a bag gets injected into the baggage handling system.

The input parameter is mostly a copy of what was returned from BaggageConformanceIdentify, but with some additional details regarding the baggage.

Access method: POST

Parameters:

• BaggageConformanceVerifyInput

Returns:

• 200 OK if the DCS accepts the bag.
• 400 Bad Request and additional explanatory text if there is an error response from the DCS.
• See HTTP Return Codes and Error Response for other HTTP return codes.

PassengerConformanceIdentify ( PassengerConformanceIdentifyInput ) : PassengerConformanceIdentifyResponse

To identify the passenger in the host departure control system and return contextual data associated to the location and device type. In the case of self-service bag drop this will be; passenger name, thru-checked flight detail and assigned bag tag numbers. The data returned will outline the passenger, their bags and their weight entitlement per bag. This is only a data retrieval operation that will not apply any applicability or eligibility rules.

Access method: POST

Parameters:

• PassengerConformanceIdentifyInput

Returns:

• 200 OK and PassengerConformanceIdentifyResponse if the DCS identifies the passenger.
• 400 Bad Request and additional explanatory text if there is an error response from the DCS.
• 404 Not found
• See HTTP Return Codes and Error Response for other HTTP return codes.

PassengerConformanceVerify ( PassengerConformanceVerifyInput ) 

To verify the passenger is eligible for further transactions at his location through verification against policy. 

Access method: POST

Parameters:

• PassengerConformanceVerifyInput

Returns:

• 200 OK if the passenger is verified by the DCS.
• 400 Bad Request and additional explanatory text if there is an error response from the DCS.
• 404 Not found
• See HTTP Return Codes and Error Response for other HTTP return codes.