Face Booking

Export the face of a ticket (mặt vé) for a booking. This endpoint is used to retrieve the printable ticket face for a given booking code and system.

---

Endpoint

• URL: /api/v1/flight/facebooking
• Method: POST
• Auth Required: Yes (Bearer Token/X-api-key)
• Content-Type: application/json

---

Authentication

This endpoint requires a valid JWT Bearer token in the Authorization header:

Authorization: Bearer <access_token>

Obtain tokens via /api/v1/sign-in (POST) with your credentials.

---

Request Structure

Field	Type	Required	Description
system	string	No	Airline system code (e.g., VN, VJ, 1A)
bookingCode	string	No	Booking code (PNR)

Example Request:

{
  "system": "VN",
  "bookingCode": "ABC123"
}

---

Request Constraints & Business Rules

• system and bookingCode must refer to a valid, active booking.
• Only authenticated users with access to the booking can export the ticket face.
• The booking must be in a state that allows face export (e.g., ticketed).

---

Response Structure

Field	Type	Nullable	Description
system	string	Yes	Name of the airline system
status	boolean	No	true if successful, false if failed
error	object	Yes	Error details (if any)
description	string	Yes	Error description (if any)
trackingId	string	Yes	Tracking ID for request logs
trackingTime	string	Yes	Time for request tracking
plainText	string	Yes	Printable ticket face (if successful)

Example Response:

{
  "system": "VN",
  "status": true,
  "description": "Face booking exported successfully",
  "trackingId": "abc-123",
  "trackingTime": "2024-06-01T12:00:00Z",
  "plainText": "<base64 or plain text of ticket face>"
}

---

Error Codes

See Error Codes for details on possible error responses.

---

Security & Validation

• All input is validated for type and required fields.
• Only authorized users can export ticket faces.
• All actions are logged and traceable.

---

Validation Questions

• What are the allowed states for a booking to export the face?
• Is the plainText always base64, or can it be plain text?
• Are there airline-specific restrictions on face export?

---

For integration support, see Contact Support.