openapi: 3.1.0
info:
  title: "Asteon Creator API"
  version: 1.0.0
  summary: "Programmatisk tilgang til ditt eget skaper-panel — spill, builds, inntekt og analyse."
  description: "Creator-API-en lar deg gjøre fra skript det du ellers gjør i Skaper-panelet: liste spillene dine, hente versjons-historikk, lese inntekt og payout-status og dra ut analytics per spill. Alle kall tagges mot din egen bruker — du kan aldri se andre skaperes data.\n\nGenerer en `agc_*`-nøkkel under [/skaper/api-nokler](https://asteon.ai/skaper/api-nokler)."
  contact:
    name: "Asteon Support"
    email: support@asteon.ai
    url: https://asteon.ai/help
  license:
    name: "Asteon Terms of Service"
    url: https://asteon.ai/terms
servers:
  - url: https://api.asteon.ai/api
    description: Produksjon
security:
  - bearerAuth: []
tags:
  - name: Konto
    description: "Sjekk hvem token-en tilhører."
  - name: Spill
    description: "List og inspiser dine egne spill."
  - name: Builds
    description: "Versjons-historikk for utgitte builds."
  - name: Inntekt
    description: "Salg, payouts og eligible balance."
  - name: Analyse
    description: "Spillere og engasjement per spill."
paths:
  /creator/me:
    get:
      tags:
        - Konto
      summary: "Hvem er jeg?"
      description: "Returnerer bruker-id, creator-id og scopes for token-en. Bruk dette som ping for å sjekke at nøkkelen virker."
      responses:
        200:
          description: Token-info
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/MeResponse"
        401:
          "$ref": "#/components/responses/Unauthorized"
  /creator/games:
    get:
      tags:
        - Spill
      summary: "List dine spill"
      responses:
        200:
          description: "Liste over spill du eier"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GamesList"
        401:
          "$ref": "#/components/responses/Unauthorized"
  "/creator/games/{id}":
    get:
      tags:
        - Spill
      summary: Spill-detalj
      parameters:
        - name: id
          in: path
          required: true
          description: "Spill-id eller slug."
          schema:
            type: string
      responses:
        200:
          description: Spill-objekt
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GameDetail"
        401:
          "$ref": "#/components/responses/Unauthorized"
        403:
          "$ref": "#/components/responses/Forbidden"
        404:
          "$ref": "#/components/responses/NotFound"
  /creator/builds:
    get:
      tags:
        - Builds
      summary: Build-historikk
      description: "Returnerer alle builds (siste 200) på tvers av dine spill, sortert nyeste først."
      responses:
        200:
          description: "Liste over builds"
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/BuildsList"
        401:
          "$ref": "#/components/responses/Unauthorized"
  /creator/earnings/summary:
    get:
      tags:
        - Inntekt
      summary: Inntekts-sammendrag
      description: "Totaler + per-spill nedbryting i et tidsvindu. Inkluderer eligible balance (saldo klar for utbetaling) og pending payouts."
      parameters:
        - name: range
          in: query
          description: "Tidsvindu, f.eks. `7d`, `30d`, `90d`. Maks 365d."
          required: false
          schema:
            type: string
            default: 30d
      responses:
        200:
          description: Inntekts-sammendrag
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/EarningsSummary"
        401:
          "$ref": "#/components/responses/Unauthorized"
  /creator/payouts:
    get:
      tags:
        - Inntekt
      summary: Payout-historikk
      description: "Inntil 100 siste payouts (alle statuser)."
      responses:
        200:
          description: Payouts
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/PayoutsList"
        401:
          "$ref": "#/components/responses/Unauthorized"
  "/creator/analytics/games/{id}":
    get:
      tags:
        - Analyse
      summary: "Analyse for ett spill"
      description: "Kjøp i tidsvinduet + total play-count og rating-snapshot. Detaljert DAU/MAU/retention er foreløpig kun tilgjengelig via session-autentisert `/api/analytics/dashboard/:projectId`."
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: range
          in: query
          required: false
          schema:
            type: string
            default: 30d
      responses:
        200:
          description: Analyse-objekt
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/GameAnalytics"
        401:
          "$ref": "#/components/responses/Unauthorized"
        403:
          "$ref": "#/components/responses/Forbidden"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: "agc_*"
      description: "Send `Authorization: Bearer agc_din_nokkel`. Generer nøkler under [/skaper/api-nokler](https://asteon.ai/skaper/api-nokler)."
  schemas:
    MeResponse:
      type: object
      properties:
        userId:
          type: string
        creatorId:
          type:
            - string
            - "null"
        displayName:
          type:
            - string
            - "null"
        scopes:
          type: array
          items:
            type: string
            enum:
              - creator:read
              - creator:write
        tokenId:
          type:
            - integer
            - "null"
    Game:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        slug:
          type: string
        status:
          type: string
          enum:
            - draft
            - review
            - published
            - rejected
        playCount:
          type: integer
        downloadCount:
          type: integer
        rating:
          type: number
        ratingCount:
          type: integer
    GamesList:
      type: object
      properties:
        games:
          type: array
          items:
            "$ref": "#/components/schemas/Game"
    GameDetail:
      type: object
      properties:
        game:
          allOf:
            - "$ref": "#/components/schemas/Game"
            - type: object
              properties:
                tags:
                  type: array
                  items:
                    type: string
                category:
                  type:
                    - string
                    - "null"
                coverImage:
                  type:
                    - string
                    - "null"
                  format: uri
    Build:
      type: object
      properties:
        id:
          type: string
        projectId:
          type: string
        target:
          type: string
          example: web
        version:
          type: string
          example: 1.0.3
        status:
          type: string
          enum:
            - pending
            - building
            - ready
            - deployed
            - failed
        createdAt:
          type: string
          format: date-time
        completedAt:
          type:
            - string
            - "null"
          format: date-time
    BuildsList:
      type: object
      properties:
        builds:
          type: array
          items:
            "$ref": "#/components/schemas/Build"
    EarningsSummary:
      type: object
      properties:
        range:
          type: object
          properties:
            days:
              type: integer
            since:
              type: string
              format: date-time
        totals:
          type: object
          properties:
            revenue:
              type: number
              description: "Netto inntekt etter platform-fee."
            sales:
              type: integer
            grossEstimate:
              type: number
              description: "Implisitt brutto før 15 % platform-fee."
            paidOut:
              type: number
            pendingPayout:
              type: number
            eligibleBalance:
              type: number
              description: "Klar for utbetaling."
        byGame:
          type: array
          items:
            type: object
            properties:
              gameId:
                type: string
              revenue:
                type: number
              sales:
                type: integer
    Payout:
      type: object
      properties:
        id:
          type: integer
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
        totalAmount:
          type: number
        currency:
          type: string
          example: USD
        createdAt:
          type: string
          format: date-time
        completedAt:
          type:
            - string
            - "null"
          format: date-time
    PayoutsList:
      type: object
      properties:
        payouts:
          type: array
          items:
            "$ref": "#/components/schemas/Payout"
    GameAnalytics:
      type: object
      properties:
        range:
          type: object
          properties:
            days:
              type: integer
            since:
              type: string
              format: date-time
        gameId:
          type: string
        purchases:
          type: integer
        playCount:
          type: integer
        rating:
          type: number
        ratingCount:
          type: integer
        note:
          type: string
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        code:
          type: string
  responses:
    Unauthorized:
      description: "Manglende eller ugyldig `agc_*`-token."
      content:
        application/json:
          schema:
            "$ref": "#/components/schemas/Error"
    Forbidden:
      description: "Token har ikke tilgang til denne ressursen."
      content:
        application/json:
          schema:
            "$ref": "#/components/schemas/Error"
    NotFound:
      description: "Ressursen finnes ikke."
      content:
        application/json:
          schema:
            "$ref": "#/components/schemas/Error"