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

HitchPin rendering API

The rendering API from HitchPin — 3 operation(s) for rendering.

HitchPin rendering API is one of 3 APIs that HitchPin publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include rendering. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 3 operations across 3 paths, and defines 6 schemas. It is described by OpenAPI 3.1.1, at version 2.0.0.

Requests are made against 5 base URLs: https://localhost, https://apiv2.sandbox.hitchpin.com, https://apiv2.staging.hitchpin.com, https://apiv2.demo.hitchpin.com, https://apiv2.hitchpin.com.

3 operations 3 paths 6 schemas 2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.1
API Version
2.0.0
Base URL
https://apiv2.hitchpin.com
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

HitchPin rendering API declares 2 security schemes for authenticating requests. An API key is passed in the cookie as sessionid (cookieAuth). An API key is passed in the header as Authorization (tokenAuth).

  • tokenAuth — Token-based authentication with required prefix "Token"

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

rendering 3
PUT
/render
Register a pre-printed receipt so that the client can securely retrieve the PDF copy.
RenderReceipt 1 param body → 200500
POST
/render-link
Register a pre-printed receipt so that the client can securely retrieve the PDF copy.
CreateReceiptUrl body → 200404
POST
/
Register a pre-printed receipt so that the client can securely retrieve the PDF copy.
ShortenUrl body → 200404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are ShortenUrlRequest (8 properties), RenderReceiptRequest (4 properties), CreateRenderedReceiptUrlRequest (2 properties), ShortenUrlResponse (1 property). Each schema is shown below with its type and property counts.

External
string
How long before the link stops working.
CreateRenderedReceiptUrlResponse
object
Response with a URL to a previously rendered receipt.
1 property 1 required
ShortenUrlResponse
object
1 property 1 required
RenderReceiptRequest
object
Request to render a receipt.
4 properties 1 required
CreateRenderedReceiptUrlRequest
object
Request to get the URL of a previously rendered receipt.
2 properties 2 required
ShortenUrlRequest
object
8 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hitchpin-rendering-api-openapi.yml Raw ↑

Other APIs HitchPin publishes across the network.

HitchPin instant-invoice-share API
HitchPin instant-invoices API