Defining a map of arbitrary translation keys in Swagger 2.0

thingy.yml

swagger: '2.0'

info:
  version: "0.0.1"
  title: Localised Thingy demonstration

definitions:
  translation:
    required:
      - default
    properties:
      default:
        type: string
    additionalProperties:
      type: string

  thingy:
    required:
      - code
    properties:
      code:
        type: string
      translations:
        $ref: '#/definitions/translation'

  localisedThingy:
    required:
      - code
      - name
    properties:
      code:
        type: string
        description: A locale code
        pattern: '^[a-z]{2}(\|[a-z]+)?$'
      name:
        type: string
        description: The localised name
paths:
  /thingies:
    get:
      description: |-
        Gets `Thingy` objects.
      responses:
        # Response code
        200:
          description: A bunch of `Thingies`
          schema:
            type: array
            items:
              $ref: '#/definitions/thingy'
  /{locale}/thingies:
    get:
      description: |-
        Gets correctly localised `Thingies`
      parameters:
        - name: locale
          in: path
          type: string
          required: true
          default: default
      responses:
        200:
          description: A bunch of localised `Thingies`
          schema:
            type: array
            items:
              $ref: '#/definitions/localisedThingy'
    

Updated based on suggestions by Ron in SO.

  thingy:
    required:
      - code
    properties:
      code:
        type: string
    additionalProperties:
      translations:
        $ref: '#/definitions/translation'

should be

  thingy:
    required:
      - code
    properties:
      code:
        type: string
      translations:
        $ref: '#/definitions/translation'

Fair enough - i think in my original schema the translations set was optional but it doesn't actually make sense that it be optional. I'll edit. Ta.

Updated version (w/webron's corrections) works with swagger-codegen-2.1.1-M1 (Java/JavaJaxRS) ... makes a Map<String,String> for 'translation' and embeds that as a property of thingy ...

That's excellent news @jreece1567