Outdated "public_keys" section in response for /store-invite in the IS spec

[babolivier]

Since matrix-org/sydent#13, Sydent changed the responses it returns on /store-invite requests from

{
  "token": "sometoken",
  "public_keys": [
    "serverpublickey",
    "ephemeralpublickey"
  ],
  "display_name": "f...@b..."
}

to

{
  "token": "sometoken",
  "public_key": "serverpublickey",
  "public_keys": [
    {
      "public_key": "serverpublickey",
      "key_validity_url": "https://vector.im/_matrix/identity/api/v1/pubkey/isvalid"
    },
    {
      "public_key": "ephemeralpublickey",
      "key_validity_url": "https://vector.im/_matrix/identity/api/v1/pubkey/ephemeral/isvalid"
    },
  ],
  "display_name": "f...@b..."
}

Currently, the spec documents the former (and outdated) format: https://matrix.org/docs/spec/identity_service/latest#post-matrix-identity-api-v1-store-invite

[babolivier]

Also the response example features a application/json top-level key, which doesn't exist in implementations.

[turt2live]

The swagger is wrong, not omitted. The application/json part is because someone forgot the s at the end of examples on the response definition.

[richvdh]

Fixed in #1486. Have filed matrix-org/sydent#561 to remove the unspecced public_key param in sydent.