Dev:PAX Portal API: Difference between revisions

From Kordeus Wiki
Jump to navigation Jump to search
Stefanseiler (talk | contribs)
No edit summary
No edit summary
 
(18 intermediate revisions by 2 users not shown)
Line 5: Line 5:
*<code>/authorize-travelagent</code>-  endpoint invoked by the [[Dev:PPA - TravelagentLoginScreen|travel agent login screen]], which does the b-op delegated authentication, which after success, stores the cookie and redirects to the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]
*<code>/authorize-travelagent</code>-  endpoint invoked by the [[Dev:PPA - TravelagentLoginScreen|travel agent login screen]], which does the b-op delegated authentication, which after success, stores the cookie and redirects to the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]


=== Overview screens endpoints ===
=== Special Assistance Request endpoints ===


* <code>[[Dev:PAX Portal API - get-assistancerequests-of-pax|/get-assistancerequests-of-pax]]</code> - Provides the passenger-digital-UID and returns the data required for the [[Dev:PPA - Overview Screen|Passenger Overview Screen]]
* <code>[[Dev:PAX Portal API - get-assistancerequests-of-pax|/specialassistancerequest/]]<nowiki/>passengers/load-all</code> - Provides the passenger-digital-UID and returns the data required for the [[Dev:PPA - Overview Screen|Passenger Overview Screen]]
* <code>/get-travelpartneroverview-fetchgroups</code> - gets the groups (from / limit) for inifinite scroll for the travel-partner-uid and travel-agent-userID on the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]
* <code>/specialassistancerequest/groups/load-all</code> - Provides group-UID and returns the data required for the list of special assistance requests on the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]
* <code>/get-assistancerequests-of-travelgroup</code> - Provides and returns the data required for the list of special assistance requests on the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]
* <code>[[Dev:PAX Portal API - CreateNewRequest|/]][[Dev:PAX Portal API - get-passenger-requestdata|specialassistancerequest]]/create</code> - Creates a new request, is done before entering the [[Dev:PPA - Screen personal & flight data entry|personal & flight data entry screen]]
* <code>/create-travelgroup</code>
* <code>/specialassistancerequest/cancel</code>- Cancels a request. If request was submitted, performs a request for cancellation, which has to be confirmed by other side.
* <code>/change-travelgroup-name</code>
* [[Dev:PAX Portal API - get-assistancerequests-of-pax|<code></code>]]<code>[[Dev:PAX Portal API - get-passenger-requestdata|/specialassistancerequest]]/load-by-uid</code>  - retrieves the data which is already known on this request (for all screens of the flow, not only [[Dev:PPA - Screen personal & flight data entry|personal & flight data entry screen]])
* <code>/remove-travelgroup</code>- is only possible on groups without any group membership
* [[Dev:PAX Portal API - get-passenger-requestdata|<code></code>]]<code>[[Dev:PAX Portal API - save-passenger-requestdata|/specialassistancerequest]]/save</code> - saves the entire request data  
* <code>/archive-travelgroup</code> - is only possible, if all requests in group are cancelled or archived
 
=== Special Assistance Request Group endpoints ===
* <code>/specialassistancerequestgroups/load-all</code> - gets the groups (from / limit) for inifinite scroll for the travel-partner-uid and travel-agent-user-uid on the [[Dev:PPA - Travel Partner Overview Screen|Travel Partner Overview Screen]]
* <code>/specialassistancerequestgroups/create-travelgroup</code>
* <code>/specialassistancerequestgroups/change-travelgroup-name</code>
* <code>/specialassistancerequestgroups/remove-travelgroup</code>- is only possible on groups without any group membership
* <code>/specialassistancerequestgroups/archive-travelgroup</code> - is only possible, if all requests in group are cancelled or archived
 
=== Documents handling ===
 
* <code>/upload-document</code> - will upload a file to a temporary folder, from which the backend will take the document into the real request location. WIll be cleared every 2 days.
* <code>/download-document</code> - will download a document from the local DMA instance.


=== Request management endpoints ===
=== Request management endpoints ===


===== General =====
* <code>[[Dev:PAX Portal API - CreateNewRequest|/createNewRequest]]</code> - Creates a new request, is done before entering the [[Dev:PPA - Screen personal & flight data entry|personal & flight data entry screen]]
* <code>[[Dev:PAX Portal API - cancelRequest|/cancelRequest]]</code> - Cancels a request. If request was submitted, performs a request for cancellation, which has to be confirmed by other side.
* <code>[[Dev:PAX Portal API - get-passenger-requestdata|/get-passenger-requestdata]]</code> - retrieves the data which is already known on this request (for all screens of the flow, not only [[Dev:PPA - Screen personal & flight data entry|personal & flight data entry screen]])
* <code>[[Dev:PAX Portal API - save-passenger-requestdata|/save-passenger-requestdata]]</code> - saves the entire request data


===== Service edit flow =====
===== Service edit flow =====
* <code>[[Dev:PAX Portal API - resolve-flightdetails-from-flightnumber-and-date|/resolve-flightdetails-from-flightnumber-and-date]]</code> - retrieves 0 or 1 matching flight details  
* <code>[[Dev:PAX Portal API - resolve-flightdetails-from-flightnumber-and-date|/resolve-flightdetails-from-flightnumber-and-date]]</code> - retrieves 0 or 1 matching flight details  
* <code>[[Dev:PAX Portal API - resolve-flights-fromto-and-date|/resolve-flights-fromto-and-date]]</code> - retrieves all possible flights for a certain date for this departure and arrival port  
* <code>[[Dev:PAX Portal API - resolve-flights-fromto-and-date|/resolve-flights-fromto-and-date]]</code> - retrieves all possible flights for a certain date for this departure and arrival port  
* <code>[[Dev:PAX Portal API - get-availabletravelserviceinfo-for-passengerrequest|/get-availabletravelserviceinfo-for-passengerrequest]]</code> - returns all information required for all display options in the service selection screen  
* <code>[[Dev:PAX Portal API - load-availabletravelserviceinfo-for-passengerrequest|/load-availabletravelserviceinfo-for-passengerrequest]]</code> - returns all information required for all display options in the [[Dev:PPA - Required Services Screen|service selection screen]]
 
 
--> get-serviceselectionpage-data
 
    --> RequestUID
 
    <-- ServiceSelectionPageDataAndOptions
 
--> send-serviceselectionpage-data
 
    --> ServiceSelectionData
 
    <-- State of Persistance
 
--> get-finalizationpage-data
 
    --> RequestUID
 
    <-- PageDataAndOptions
 
--> send-finalizationpage-data
 
    --> ServiceSelectionData
 
    <-- State of Persistance
 
-->
 
    --> requestID
 
    <-- OK
 
--> file-request
 
    --> requestID
 
    <-- OK
 
== See also ==
== See also ==


* [[Dev:PAX.Portal Application Development]]
* [[Dev:PAX.Portal Application Development]]

Latest revision as of 08:33, 5 September 2025

User authentication endpoints

  • /paxportal-authorize-travelid-start - this triggers the user authentication a TravelID-account
  • /paxportal-authorize-travelid-callback - the callback endpoint for travelID, which creates after successful authentication a local user access token and stores it as cookie and redirects the user to the Passenger Overview Screen
  • /authorize-travelagent- endpoint invoked by the travel agent login screen, which does the b-op delegated authentication, which after success, stores the cookie and redirects to the Travel Partner Overview Screen

Special Assistance Request endpoints

Special Assistance Request Group endpoints

  • /specialassistancerequestgroups/load-all - gets the groups (from / limit) for inifinite scroll for the travel-partner-uid and travel-agent-user-uid on the Travel Partner Overview Screen
  • /specialassistancerequestgroups/create-travelgroup
  • /specialassistancerequestgroups/change-travelgroup-name
  • /specialassistancerequestgroups/remove-travelgroup- is only possible on groups without any group membership
  • /specialassistancerequestgroups/archive-travelgroup - is only possible, if all requests in group are cancelled or archived

Documents handling

  • /upload-document - will upload a file to a temporary folder, from which the backend will take the document into the real request location. WIll be cleared every 2 days.
  • /download-document - will download a document from the local DMA instance.

Request management endpoints

Service edit flow

See also