Slice Shops API

openapi: 3.0.3
info:
  title: Slice Public Orders Shops API
  description: 'The Slice Public API is a RESTful HTTP API for technology partners integrating

    with the Slice network of independent local pizzerias. It exposes pizzeria-oriented

    resources — shops and orders — so partners can discover Slice shops and create,

    retrieve, update, and cancel orders against them.


    This is the **v1** surface of the Slice Public API, documented on Slice''s Stoplight

    developer portal at https://developer.slicelife.com (project `slice-public-api`,

    spec node `/API-V1.yaml`).


    The paths, methods, operation summaries, and component-schema names in this

    description were reconstructed from Slice''s live Stoplight project node tree, which

    is publicly enumerable. The raw OpenAPI document body and per-property schema

    definitions on developer.slicelife.com are gated behind workspace authentication,

    so individual schema properties are intentionally NOT enumerated here — the

    `Order` and `Error` schemas are declared as objects without invented fields. The

    server URL is also not published publicly and is therefore omitted rather than

    fabricated; partners obtain it together with credentials from Slice.


    Access requires an API key issued by Slice; partners request credentials from

    api-support@slicelife.com.'
  version: v1
  contact:
    name: Slice API Support
    email: api-support@slicelife.com
    url: https://developer.slicelife.com/
  x-generated-from: stoplight-node-tree
  x-spec-node: /API-V1.yaml
  x-spec-node-stable-id: 5yhsktwvkfni9
  x-properties-source: 'Operation paths/methods/summaries are confirmed-real from the live Stoplight

    project node tree. Schema property internals were auth-gated and are not

    enumerated to avoid fabrication.'
  x-last-validated: '2026-06-03'
security:
- ApiKeyAuth: []
tags:
- name: Shops
  description: Discover pizzerias (shops) in the Slice network.
paths:
  /shops:
    get:
      operationId: getShops
      summary: Get Shops
      description: 'Returns shops (independent pizzerias) available in the Slice network.

        Confirmed operation from the Stoplight node `/API-V1.yaml/paths/~1shops/get`.'
      tags:
      - Shops
      responses:
        '200':
          description: A collection of Slice shops.
        '401':
          $ref: '#/components/responses/Unauthorized'
        default:
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: An error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication failed or API key is missing/invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      title: Error
      description: 'A Slice API error payload. Corresponds to the shared `error` model

        (`/models/error.yaml`) referenced by the spec. Property internals are

        auth-gated and not enumerated here to avoid fabrication.'
      additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key issued by Slice to approved technology partners. Request credentials

        from api-support@slicelife.com. The exact header name is assigned with the

        credentials; `Authorization` is used here as the documented placeholder.'
externalDocs:
  description: Slice Public API documentation (Stoplight)
  url: https://developer.slicelife.com/