An endpoint list answers the question “what can this call do”. It does not answer the question a business actually has: “how do I get this task done”. The use cases on this page therefore start from the task and name the calls that complete it together — each with its prerequisites, a billing note and its limits.
The four surfaces are not exclusive. For a recycler the Hub and Compliance are relevant options, for a parts dealer the Hub and Commerce, for a software vendor building for many businesses all four — each surface at its own maturity. Authoritative for every path named is the OpenAPI contract of the respective surface.
The four surfaces and their maturity
| Surface | Maturity | Use cases |
|---|---|---|
| Hub | productive | 12 |
| Sales agent | pilot — entitlement required | 8 |
| Commerce | preview — no productive channel changes | 11 |
| Compliance | documentation preview — not yet activated | 9 |
All use cases
If you do not yet know where to start
- You have a photo. The image route runs from the part photo to the listing: from the part photo to the listing.
- You have an OE number. The OE route leads to a marketplace-ready article: from the OE number to the article.
- You have a vehicle identification number. The VIN route leads to the economic assessment: from the VIN to the appraisal.
- You are integrating for many businesses. Then it starts with tenant administration: many businesses on one access.
Where the binding statements live
Field lists, error codes and sample responses live in the OpenAPI contracts at docs.tapinomahub.com. The texts here explain the context; in case of doubt the contract governs.
Sources and legal references
Frequently asked
How does a use case differ from an endpoint article?
The endpoint article describes one call. A use case describes a task needing several calls and justifies the order — including the stages people like to skip.
Can I use several surfaces at once?
The surfaces are not exclusive, but they have separate contracts and their own maturity; for a recycler Hub and Compliance are relevant options.
Are all surfaces available productively?
The Hub runs productively; Compliance is a documentation preview whose endpoints are not yet activated on the target server. The sales agent is run as a pilot and needs an entitlement. Commerce is a preview and performs no productive channel changes and no fee collection.