Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

1Factory Suppliers API

Data shared with your organization by your suppliers, or details about your suppliers.

1Factory Suppliers API is one of 7 APIs that 1Factory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Suppliers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 8 JSON Schemas.

This API exposes 8 operations across 8 paths, and defines 43 schemas. It is described by OpenAPI 3.0.3, at version 24.31.

Requests are made against 5 base URLs: https://www.1factory.co/api/v1, https://www.1factory.com/api/v1, https://val.1factory.co/api/v1, https://val.1factory.com/api/v1, https://localhost/api/v1.

8 operations 8 paths 43 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
24.31
Base URL
https://www.1factory.com/api/v1
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

1Factory Suppliers API declares 2 security schemes for authenticating requests. An API key is passed in the header as x-1factory-org (OrgId). An API key is passed in the header as x-1factory-key (ApiKey). By default, every request must be authenticated.

  • OrgId — ID of your organization in 1Factory. Available in the Settings page of the 1Factory application.
  • ApiKey — API key for your organization. Generated in the Settings page of the 1Factory application.

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

Suppliers 8

Data shared with your organization by your suppliers, or details about your suppliers.

GET
/sup
1Factory Gets a List of Suppliers in Your Organization.
6 params → 200400401
GET
/sup/{supplier_id}
1Factory Get Detailed Supplier Record
1 param → 200400401404
GET
/sup/plans
1Factory Gets a List of Plans Shared with Your Organization by Your Suppliers.
13 params → 200400401
GET
/sup/plans/{plan_id}
1Factory Gets a Detailed Supplier Plan Record.
1 param → 200400401404
GET
/sup/inspections
1Factory Gets a List of Inspections Shared with Your Organization by Your Suppliers.
15 params → 200400401
GET
/sup/inspections/{inspection_id}
1Factory Gets a Detailed Supplier Inspection Record.
1 param → 200400401404
GET
/sup/fais
1Factory Gets a List of First-article Inspections Shared with Your Organization by Your Suppliers.
11 params → 200400401
GET
/sup/fais/{inspection_id}
1Factory Gets a Detailed Supplier First-article Inspection Record.
1 param → 200400401404

Schemas 43

The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are Inspection (31 properties), Fai (28 properties), Specification (19 properties), PlanDetail (19 properties). Each schema is shown below with its type and property counts.

insp_ident_2
string
Secondary identifier for an inspection or FAI, for example a Customer Purchase Order or Lot . For FAIs this is the 'PO Number'. (Optional)
parts_passed
number
The number of parts that pass inspection.
operation
string
Operation of the inspection. No operation specified or an operation of 'All' indicates that an inspection is for all operations in the inspection Plan. (Only f…
inspection_type
string
Type of inspection, as defined in your organization's Inspection Types List of Values
lot_size
integer
Number of parts in lot being inspected
SpecInspectionType
object
4 properties
Address
object
5 properties
number_of_parts
integer
Number of parts inspected.
status
string
The status of the object
part_description
string
Description of the part.
Plan
object
18 properties
InspectionList
array
PlanDetail
object
19 properties
closed_on
string
Date & time that an object was closed.
Fai
object
28 properties
project_identifier
Name of projectidentifier to filter on. Must come from your organization's Part Master Project Identifier LOV. (The name used in the UI for this LOV is configu…
created_by_username
string
Name of user that created the entity.
Specification
object
Specification that defines feature to be measured.
19 properties
FaiDetail
object
Detailed first-article inspection data, including feature specifications and measurement data.
Inspection
object
31 properties
SupplierList
array
insp_ident_3
string
Tertiary identifier for an inspection, for example a Customer Purchase Order or Lot . (Optional)
FaiList
array
rev
string
Part revision. Together with part number, uniquely identifies a part.
fai_type
string
Type of first-article inspection.
machines
array
List of machines for the inspection. Only for manufacturing inspections. Entries in this list must match the Mfg. Resources - Machines LOV configured for your…
insp_ident_1
string
Primary identifier for an inspection or FAI, for example a Work Order or Purchase Order. For FAIs, this is the 'FAI Number'. Must be unique for each entry when…
Certification
object
2 properties 2 required
supplier_number
string
The supplier number / vendor code (for receiving or supplier inspections).
ID
integer
Unique identifier for the Inspection, assigned by 1Factory.
InspectionDetail
object
Detailed inspection data, including feature specifications and measurement data.
parts_failed
number
The number of parts that failed inspection.
PartData
object
Inspection data for a single part.
4 properties
Qualification
object
4 properties 4 required
Supplier
object
18 properties 3 required
part_number
string
Part number. Together with rev, uniquely identifies a part.
created_on
string
Date & time that an object was created.
supplier_name
string
The name of the supplier (for receiving or supplier inspections).
User
object
3 properties 3 required
Error
object
2 properties
updated_on
string
Date & time that an object was last updated.
customer_name
string
The name of the customer (for manufacturing inspections).
PlanList
array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

1factory-suppliers-api-openapi.yml Raw ↑

Other APIs 1Factory publishes across the network.

1Factory Customers API
1Factory Manufacturing API
1Factory Part Master API
1Factory QMS API
1Factory Receiving API
1Factory Work Orders API