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

Hour One general API

The general API from Hour One — 3 operation(s) for general.

Hour One general API is one of 6 APIs that Hour One publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 3 operations across 3 paths, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, /api/v1.

3 operations 3 paths 7 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.makereals.com/api/v1
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Hour One general API declares 2 security schemes for authenticating requests. An API key is passed in the header as api-key (APIKeyHeader). It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 3

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

general 3
POST
/examples
Create Example
create_example_examples_post 2 params body → 200422
GET
/examples/create-video
Create Video Call Example
create_video_call_example_examples_create_video_get 4 params → 200422
GET
/analytics/summary
Get Summary
get_summary_analytics_summary_get 4 params → 200422

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are UsageResponse (6 properties), ValidationError (3 properties), CreateExampleRequest (3 properties), ExampleResponse (2 properties). Each schema is shown below with its type and property counts.

ExampleResponse
object
2 properties 2 required
CreateExampleRequest
object
3 properties 1 required
ExampleTypes
string
An enumeration.
ValidationError
object
3 properties 3 required
UsageResponse
object
6 properties 2 required
UsageBreakdown
string
An enumeration.
HTTPValidationError
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hour-one-general-api-openapi.yml Raw ↑

Other APIs Hour One publishes across the network.

Hour One keys API
Hour One playground API
Hour One videos API
Hour One voice-preview API
Hour One webhook API