/tickets/{ticketId}/qr:
get:
summary: Get ticket QR code
description: Return an image of your ticket with scannable QR code. Used for event entry.
operationId: getTicketCode
tags:
- Tickets
parameters:
- $ref: "#/components/parameters/TicketId"
responses:
"200":
description: Scannable event ticket in image format.
content:
image/png:
schema:
$ref: "#/components/schemas/GetTicketCodeResponse"
"400":
$ref: '#/components/responses/BadRequest'
"404":
$ref: '#/components/responses/NotFound'
/tickets/{ticketId}/pkpass:
get:
summary: Get pkpass for a ticket
description: Return a pkpass for your ticket. Can be added to your wallet app and used for event entry.
operationId: getPkpass
tags:
- Tickets
parameters:
- $ref: "#/components/parameters/TicketId"
responses:
"200":
description: Pkpass for a ticket.
content:
application/json:
schema:
$ref: "#/components/schemas/GetPkpassResponse"
"400":
$ref: '#/components/responses/BadRequest'
"404":
$ref: '#/components/responses/NotFound'
- Endpoint URL: Updated from
/tickets/{ticketId}/qr
to/tickets/{ticketId}/pkpass
. - Response Format: Changed from image/png to application/json.
- Description Update: Clarified that the pkpass can be added to a wallet app for use.
- Enhanced User Experience: Users can easily add tickets to their mobile wallets with a tap.
- Dynamic Updates: Real-time updates for event details without issuing new tickets.
- Security: Encrypted and digitally signed, reducing fraud risks.
- API Integration: Update API clients to call the new
/pkpass
endpoint. - Backend Updates: Adjust backend systems to generate and serve pkpass files in JSON format.
- Client Communication: Notify users of the transition from QR codes to pkpass tickets, emphasizing benefits and instructions for adding tickets to their wallet apps.
- Testing: Conduct thorough testing to ensure the new endpoint functions correctly across different scenarios.
- Rollout Plan: Deploy changes gradually, starting with internal testing and then moving to a phased rollout for external users.
- API Documentation: Revise documentation to reflect the new endpoint and provide examples of retrieving and using pkpass tickets.
- User Guides: Create user guides or FAQs explaining how to add pkpass tickets to various wallet apps (e.g., Apple Wallet).
- Customer Support: Prepare support teams with knowledge about pkpass tickets to assist users with any questions or issues.
- Feedback Collection: Gather feedback from users to continuously improve the ticketing experience.