{
  "openapi": "3.1.0",
  "info": {
    "title": "zpe front door",
    "version": "1.0.0",
    "summary": "What the front door says, as data: the registry counts the page prints, and the addresses it links.",
    "description": "The response to this operation is the object the page at https://zpe.vc/ is rendered from in the same request, so a figure in the response and a figure on the page are the same figure. Counts come from the fleet registries (~/Projects/app-registry/apps.json and ~/Projects/api-registry/api.json), whose commits are named in `sources`. The `example` beside the schema is an illustration with fixed figures and is deliberately not a measurement: read the response for the numbers of the day. Nothing here needs a key, an account or a cookie.",
    "contact": {
      "url": "https://zpe.vc/contact"
    }
  },
  "servers": [
    {
      "url": "https://zpe.vc",
      "description": "the front door"
    }
  ],
  "tags": [
    {
      "name": "home",
      "description": "The page, as data."
    }
  ],
  "paths": {
    "/_/api/v1/home": {
      "get": {
        "operationId": "getHome",
        "tags": [
          "home"
        ],
        "summary": "The home page model",
        "description": "Every count the page prints, the addresses it links, and the list of apps a stranger can open.",
        "responses": {
          "200": {
            "description": "The model.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Home"
                },
                "example": {
                  "as_of": "2026-01-01",
                  "sources": {
                    "apps": "0000000",
                    "apis": "0000000"
                  },
                  "counts": {
                    "open": 2,
                    "account": 1,
                    "contracts": 2,
                    "operations": 7,
                    "total": 5,
                    "wip": 2
                  },
                  "links": {
                    "wall": "https://zpe.vc/start",
                    "docs": "https://zpe.vc/api/docs",
                    "spec": "https://zpe.vc/_/api/v1/openapi.json",
                    "door": "https://auth.zpe.vc/",
                    "offer": "https://zpe.vc/services/",
                    "status": "https://status.zpe.vc"
                  },
                  "open": [
                    {
                      "id": "an-app",
                      "label": "An app you can open",
                      "href": "https://an-app.example",
                      "api": "https://an-app.example/_/api/v1"
                    },
                    {
                      "id": "a-page",
                      "label": "A page with no API",
                      "href": "https://a-page.example",
                      "api": null
                    }
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/_/api/v1/openapi.json": {
      "get": {
        "operationId": "getHomeContract",
        "tags": [
          "home"
        ],
        "summary": "This document",
        "responses": {
          "200": {
            "description": "The OpenAPI 3.1 document for this surface.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Home": {
        "type": "object",
        "required": [
          "as_of",
          "sources",
          "counts",
          "links",
          "open"
        ],
        "properties": {
          "as_of": {
            "type": "string",
            "description": "The day the registry artifacts were committed."
          },
          "sources": {
            "type": "object",
            "properties": {
              "apps": {
                "type": "string",
                "description": "Commit of the app registry."
              },
              "apis": {
                "type": "string",
                "description": "Commit of the API registry."
              }
            }
          },
          "counts": {
            "type": "object",
            "properties": {
              "open": {
                "type": "integer",
                "description": "Public apps, not still being worked on."
              },
              "account": {
                "type": "integer",
                "description": "Apps behind the one account."
              },
              "contracts": {
                "type": "integer",
                "description": "Apps publishing a machine contract."
              },
              "operations": {
                "type": "integer",
                "description": "Operations across those contracts."
              },
              "total": {
                "type": "integer",
                "description": "Apps in the registry."
              },
              "wip": {
                "type": "integer",
                "description": "Apps still being worked on."
              }
            }
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            }
          },
          "open": {
            "type": "array",
            "description": "The apps a stranger can open, in registry order.",
            "items": {
              "type": "object",
              "required": [
                "id",
                "label",
                "href"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "href": {
                  "type": "string",
                  "format": "uri"
                },
                "api": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The versioned base, when the app has one."
                }
              }
            }
          }
        }
      }
    }
  },
  "x-surface": {
    "app": "zpe-vc",
    "base": "/_/api/v1",
    "document": "/_/api/v1/openapi.json",
    "generated_by": "src/home/api.ts openapi"
  },
  "x-zpe-routes": 3,
  "x-zpe-documented": 2,
  "x-zpe-internal": [
    "GET /_/api/v1/404s"
  ]
}