Phasio Customer Requisition Controller API
API for customers to view requisitions in their orders
OpenAPI Specification
openapi: 3.1.0
info:
title: Phasio Activity Internal Customer Requisition Controller API
description: This is the API documentation for the Phasio application.
version: '1.0'
servers:
- url: https://m-api.eu.phas.io
description: Generated server url
security:
- Phasio API Bearer Token: []
tags:
- name: Customer Requisition Controller
description: API for customers to view requisitions in their orders
paths:
/api/customer/v1/requisition:
get:
tags:
- Customer Requisition Controller
summary: Get requisitions by order ID
description: Retrieves all requisitions for the specified order
operationId: getPartsByOrder
parameters:
- name: orderId
in: query
description: ID of the order to retrieve requisitions for
required: true
schema:
type: integer
format: int64
example: 1
responses:
'200':
description: Successfully retrieved requisitions
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RequisitionDto'
'401':
description: Unauthorized - missing customer or operator context
/api/customer/v1/requisition/{requisitionId}:
get:
tags:
- Customer Requisition Controller
summary: Get part revision
description: Retrieves a specific part revision by ID
operationId: get_29
parameters:
- name: requisitionId
in: path
description: ID of the part revision to retrieve
required: true
schema:
type: integer
format: int64
responses:
'200':
description: Part revision successfully retrieved
content:
application/json:
schema:
$ref: '#/components/schemas/PartRevisionDto'
'401':
description: Unauthorized - missing or invalid authentication
'404':
description: Part revision not found
/api/customer/v1/requisition/{requisitionId}/thumbnail:
get:
tags:
- Customer Requisition Controller
summary: Download part thumbnail
description: Downloads the thumbnail image for a requisition
operationId: downloadThumbnail_2
parameters:
- name: requisitionId
in: path
description: ID of the requisition
required: true
schema:
type: integer
format: int64
responses:
'200':
description: Thumbnail successfully downloaded
content:
image/png: {}
'400':
description: Invalid requisition ID or thumbnail not available
'401':
description: Unauthorized - missing or invalid authentication
/api/customer/v1/requisition/{requisitionId}/download/{type}:
get:
tags:
- Customer Requisition Controller
summary: Download part revision file
description: Downloads a specific file type associated with a part revision
operationId: downloadFile_1
parameters:
- name: requisitionId
in: path
description: ID of the part revision
required: true
schema:
type: integer
format: int64
- name: type
in: path
description: Type of file to download
required: true
schema:
type: string
enum:
- ORIGINAL_CAD_FILE
- CORE_GEOMETRY
- THUMBNAIL
- PDF_DESIGN_FILE
- WALL_THICKNESS_ANALYSIS
responses:
'200':
description: File downloaded successfully
content:
application/octet-stream: {}
'400':
description: File not found or download failed
'401':
description: Unauthorized - operator not found
components:
schemas:
FixedOrientationConstraintDto:
allOf:
- $ref: '#/components/schemas/ConstraintDto'
- type: object
properties:
rotationMatrix:
type: array
items:
type: array
items:
type: number
required:
- constraintType
- createdAt
- id
- partSpecificationId
- rotationMatrix
- updatedAt
PartRevisionDto:
type: object
properties:
partRevisionId:
type: string
format: uuid
designName:
type: string
designId:
type: string
format: uuid
availableAccessories:
type: array
items:
type: string
enum:
- ORIGINAL_CAD_FILE
- CORE_GEOMETRY
- THUMBNAIL
- PDF_DESIGN_FILE
- WALL_THICKNESS_ANALYSIS
volume:
type: number
area:
type: number
height:
type: number
width:
type: number
depth:
type: number
minimumWallThickness:
type: number
minBoundingBoxVolume:
type: number
convexHullVolume:
type: number
shrinkWrapVolume:
type: number
createdAt:
type: string
format: date-time
versionNumber:
type: integer
format: int64
isLatestRevision:
type: boolean
repaired:
type: boolean
watertight:
type: boolean
originalCADFileType:
type: string
enum:
- STL
- OBJ
- WRL
- STEP
- STP
- IGES
- IGS
- THREEMF
- DXF
- ZIP
- THREEDS
- BLEND
- DAE
- FBX
- BREP
- BDF
- MSH
- INP
- DIFF
- MESH
- CTM
- PLY
- 'OFF'
- COLLADA
- GLTF
- XAML
- THREEDXML
- XYZ
conflictOnHash:
type: string
baseRotationMatrix:
type: array
items:
type: number
deleted:
type: boolean
required:
- availableAccessories
- deleted
- designName
ConstraintDto:
type: object
discriminator:
propertyName: constraintType
properties:
id:
type: string
format: uuid
constraintType:
type: string
partSpecificationId:
type: string
format: uuid
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
required:
- constraintType
- createdAt
- id
- partSpecificationId
- updatedAt
RequisitionDto:
type: object
properties:
id:
type: integer
format: int64
orderId:
type: integer
format: int64
partRevisionId:
type: string
format: uuid
units:
type: string
enum:
- CENTIMETERS
- MILLIMETERS
- METRES
- INCHES
- FEET
name:
type: string
quantity:
type: integer
colorId:
type: integer
format: int64
precisionId:
type: integer
format: int64
materialId:
type: integer
format: int64
processPricesId:
type: string
format: uuid
infillId:
type: integer
format: int64
pricePaid:
type: number
postProcessingIds:
type: array
items:
type: integer
format: int64
watertight:
type: boolean
createdAt:
type: string
format: date-time
lastUpdated:
type: string
format: date-time
leadTimeId:
type: string
format: uuid
constraints:
type: array
items:
oneOf:
- $ref: '#/components/schemas/ConstraintDto'
- $ref: '#/components/schemas/FixedOrientationConstraintDto'
required:
- constraints
- createdAt
- id
- lastUpdated
- materialId
- name
- orderId
- partRevisionId
- postProcessingIds
- processPricesId
- quantity
- units
- watertight
securitySchemes:
Phasio API Bearer Token:
type: http
name: Authorization
in: header
scheme: bearer
bearerFormat: JWT