Pickly

Create a Pickly poll to help a group decide something together (where to eat, which date, what to watch) and get a link to share in the group chat. Nobody needs an account to vote.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "What the group is deciding, e.g. \"Where do we eat on Friday?\""
    },
    "description": {
      "description": "Optional extra context shown under the question.",
      "type": "string"
    },
    "votingStyle": {
      "default": "multi",
      "description": "How people vote. multi: tick every option that works (the default, good for most choices). ranked: put the options in order; an instant runoff picks the winner. score: 1 to 5 stars each. swipe: yes or no per option, one card at a time. availability: yes, if need be, or no per option; best for finding a date that suits everyone.",
      "type": "string",
      "enum": [
        "multi",
        "ranked",
        "score",
        "swipe",
        "availability"
      ]
    },
    "optionKind": {
      "default": "text",
      "description": "What every option is: a named thing, a calendar date, a time of day, or a place.",
      "type": "string",
      "enum": [
        "text",
        "date",
        "time",
        "place"
      ]
    },
    "options": {
      "minItems": 2,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "description": "The option's name. Needed for text and place options.",
            "type": "string"
          },
          "date": {
            "description": "Date options: YYYY-MM-DD.",
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "time": {
            "description": "Time options: HH:MM, 24-hour. Optional on date options.",
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$"
          },
          "note": {
            "description": "Date and time options: a short note, e.g. \"after work\".",
            "type": "string"
          },
          "address": {
            "description": "Place options: the place's own address, e.g. a restaurant's street address.",
            "type": "string"
          },
          "url": {
            "description": "Text and place options: an http(s) link, e.g. a menu or a listing.",
            "type": "string"
          }
        }
      },
      "description": "2 to 20 options, all of the optionKind."
    },
    "maxChoices": {
      "description": "multi polls only: how many options each person may tick. Leave out for no limit.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "closesInHours": {
      "description": "When voting closes, in hours from now. Defaults to 24.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 8760
    }
  },
  "required": [
    "question",
    "options"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read the current standings of a Pickly poll: who's winning, by how much, and whether voting has closed.

{
  "type": "object",
  "properties": {
    "poll": {
      "type": "string",
      "description": "The poll's link (https://usepickly.com/p/…) or its id."
    }
  },
  "required": [
    "poll"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}