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

Tackle Registrations API

Operations for Order Registrations

Tackle Registrations API is one of 25 APIs that Tackle publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Registrations. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 1 operation across 1 path, and defines 23 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.tackle.io.

1 operations 1 paths 23 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.tackle.io
Authentication
HTTP Bearer, HTTP Basic, API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 4

Tackle Registrations API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (BearerAuth). It accepts HTTP basic authentication (BasicAuthCallback). An API key is passed in the header as subscription-key (HeaderApiKeyAuthCallback). It supports OAuth 2.0 (Oauth2AuthCallback) using the clientCredentials flow.

  • BearerAuth — The Tackle API requires a JWT for authentication. You can get this by [getting your API credentials](https://developers.tackle.io/docs/how-to-get-an-m2m-client…
  • BasicAuthCallback — Use basic for [basic HTTP authentication](https://en.wikipedia.org/wiki/Basicaccessauthentication); this is only used for callbacks
  • HeaderApiKeyAuthCallback — Use headerapikey to specify a custom HTTP request header for authentication. Requests from Tackle will use the specified HTTP header for outbound requests to y…
  • Oauth2AuthCallback — This auth-type is for oauth2 client credentials flow. We will use the clientid and clientsecret to call the tokenurl to get an access token; this is only used…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Registrations 1

Operations for Order Registrations

POST
/v1/registrations
Register an Order
v1-create-registration body → 200400401403404

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are GcpEntitlement (17 properties), RedHatEntitlement (9 properties), AzureEntitlement (5 properties), Error (4 properties). Each schema is shown below with its type and property counts.

AwsCustomerId
string
AWS Account Reference ID
CustomerId
RedHatCustomerId
string
Red Hat Customer Id
RedHatSubscriptionRenewType
string
Renew Type
RedHatTermUnit
string
The unit for the term
GcpEntitlement
object
A purchase entitlement from GCP Marketplace
17 properties 5 required
AzureCustomerId
string
Azure Subscription ID
AzureEntitlement
object
A purchase entitlement from Azure Marketplace
5 properties 5 required
Error
object
4 properties 3 required
AwsProductId
string
AWS Product Code
GcpCustomerId
string
GCP External Account ID
Entitlement
object
A purchase entitlement for a given cloud marketplace
ProductId
Cloud Marketplace issued ID for a product
AzureProductId
string
Azure Offer ID
RedHatSubscriptionType
string
Type of the subscription
GcpProductId
string
GCP Solution ID
RegistrationDetails
object
Registration details of a purchaser that map to defined registration page fields for a given listing. The following fields are required at a minimum: - Company…
3 properties 3 required
RegistrationsRequest
object
3 properties 3 required
Entitlements
array
A list of Entitlement objects
RedHatEntitlement
object
A purchase entitlement from Red Hat Marketplace
9 properties 9 required
RegistrationsResponse
object
1 property 1 required
RedHatProductId
string
Red Hat Product Id
AwsEntitlement
object
A purchase entitlement from AWS Marketplace
4 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tackle-registrations-api-openapi.yml Raw ↑

Other APIs Tackle publishes across the network.

Tackle Authentication API
Tackle Contracts API
Tackle Currencies API
Tackle Disbursements API
Tackle Entitlements API
Tackle Groups API
Tackle Invitations API
Tackle Invoices API
Tackle Marketplace API
Tackle Metering API
Tackle Notifications API
Tackle Opportunities API