API

Draft service boundary

This API page is a map for future work. There is no public Speconaut API endpoint yet; the live demo behavior still belongs to specifications.global.

Availability

Public APINot available

OpenAPI draftPublished as static JSON

Auth backendPlanned

SMS gatewayNot connected

Draft Endpoints

POST /v1/ask

Ask a product question with optional page, locale, session, and previous-context data.

GET /v1/products/{id}

Read a normalized product summary, known aliases, variants, and source references.

POST /v1/sessions

Create a conversation session for web, retail, or partner client use.

POST /v1/products/search

Search normalized product identities, aliases, model numbers, and known source traces.

POST /v1/auth/sms/request

Start SMS verification after a phone provider is selected. Placeholder only.

POST /v1/auth/sms/verify

Verify an SMS code and bind the phone number to an account. Placeholder only.

Static draft: /openapi/speconaut.v0.json

Future Auth Model

Speconaut is expected to support Google, Apple, email, phone number, and SMS verification. Those modes are represented on the login page now so product decisions can be discussed early.

Contract Notes

{
  "question": "Which phone is better for camera work?",
  "locale": "en-US",
  "context": {
    "source": "specifications.global",
    "previous": "optional follow-up context"
  },
  "answer_format": "markdown"
}