"Fossies" - the Fresh Open Source Software Archive

Member "jitsi-meet-6316/resources/cloud-api.swagger" (5 Jul 2022, 5051 Bytes) of package /linux/misc/jitsi-meet-6316.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 swagger: "2.0"
    2 info:
    3   description: "Documents the REST calls used by Jitsi Meet to integrate with other services"
    4   version: "1.0.0"
    5   title: "Swagger Video"
    6   termsOfService: "https://jitsi.org/CloudAPITOS/"
    7   contact:
    8     email: "team@jitsi.org"
    9 host: "jitsi-api.jitsi.org"
   10 basePath: "/"
   11 tags:
   12 - name: "conferenceMapper"
   13   description: "Conference to ID Mapper"
   14   externalDocs:
   15     description: "Conference API Details"
   16     url: "https://jitsi.org/CloudAPI"
   17 - name: "phoneNumberList"
   18   description: "List of dial-in numbers"
   19 schemes:
   20   - "https"
   21 paths:
   22   /conferenceMapper:
   23     get:
   24       tags:
   25       - "conferenceMapper"
   26       summary: "Create or retrieve conference ID mapping"
   27       description: "When called with a conference, creates a new ID and both stores and returns the result.  When called with an ID, returns the mapping if previously created."
   28       operationId: "GETconferenceMapper"
   29       consumes:
   30       - "application/json"
   31       produces:
   32       - "application/json"
   33       parameters:
   34       - in: "query"
   35         name: "conference"
   36         type: "string"
   37         format: "JID"
   38         description: "Full JID (room@conference.server.domain) for the conference to create or return existing conference mapping.  Used preferentially over all other input parameters (search by conference)"
   39       - in: "query"
   40         name: "id"
   41         type: "number"
   42         description: "ID to search for existing conference mapping.  Only used when provided alone (search by ID)"
   43       responses:
   44         200:
   45           description: "mapping search performed"
   46           schema:
   47             $ref: "#/definitions/ConferenceMapperDetails"
   48         405:
   49           description: "Invalid input"
   50     post:
   51       tags:
   52       - "conferenceMapper"
   53       summary: "Create or retrieve conference ID mapping"
   54       description: "When called with a conference, creates a new ID and both stores and returns the result.  When called with an ID, returns the mapping if previously created."
   55       operationId: "POSTconferenceMapper"
   56       consumes:
   57       - "application/json"
   58       produces:
   59       - "application/json"
   60       parameters:
   61       - in: "body"
   62         name: "body"
   63         description: "Conference Mapper Request"
   64         required: true
   65         schema:
   66           $ref: "#/definitions/ConferenceMapperRequest"
   67       responses:
   68         200:
   69           description: "mapping search performed"
   70           schema:
   71             $ref: "#/definitions/ConferenceMapperDetails"
   72         405:
   73           description: "Invalid input"
   74 
   75   /phoneNumberList:
   76     get:
   77       tags:
   78       - "phoneNumberList"
   79       summary: "Returns a list phone numbers by country"
   80       description: "Used to populate the Share The Link section of jitsi-meet"
   81       operationId: "phoneNumberList"
   82       produces:
   83       - "application/json"
   84       responses:
   85         200:
   86           description: "successful operation"
   87           schema:
   88             type: array
   89             $ref: "#/definitions/PhoneNumberListAnswer"
   90 securityDefinitions:
   91   token:
   92     type: "apiKey"
   93     name: "token"
   94     in: "query"
   95   Bearer:
   96     type: "apiKey"
   97     name: "Authorization"
   98     in: "header"
   99 definitions:
  100 
  101   ConferenceMapperRequest:
  102     description: "Request to create or find a conference mapping"
  103     type: "object"
  104     properties:
  105       id:
  106         type: "number"
  107         description: "ID to search for existing conference mapping.  Only used when provided alone (search by ID)"
  108       conference:
  109         type: "string"
  110         format: "JID"
  111         description: "Full JID (room@conference.server.domain) for the conference to create or return existing conference mapping.  Used preferentially over all other input parameters (search by conference)"
  112       room:
  113         type: "string"
  114         description: "Room part of the conference.  Required if 'conference' is not provided.  Used to generate a 'conference' value (search by conference)"
  115       domain:
  116         type: "string"
  117         description: "Domain part of the conference.  Used if 'conference' is not provided.  Defaults to domain of the API endpoint.   Used to generate a 'conference' value (search by conference)"
  118 
  119   ConferenceMapperDetails:
  120     description: "Conference mapping between conference JID and numeric ID"
  121     type: "object"
  122     properties:
  123       id:
  124         type: "number"
  125         description: "Unique ID mapped to conference"
  126       conference:
  127         type: "string"
  128         format: "JID"
  129         description: "Full JID for the conference OR boolean false if no conference was found (search by ID)"
  130 
  131   PhoneNumberListAnswer:
  132     description: "Answer with Phone number list and additional information"
  133     type: "object"
  134     properties:
  135       countryCode:
  136         type: string
  137       formattedNumber:
  138         type: string
  139       tollFree:
  140         type: boolean
  141     example:
  142       {"countryCode":"US","tollFree":false,"formattedNumber":"+1 123-456-7890"}
  143       {"countryCode":"UK","tollFree":true,"formattedNumber":"+44 123 456 7890"}
  144 
  145 externalDocs:
  146   description: "Find out more about the Jitsi Cloud API"
  147   url: "https://jitsi.org/CloudAPI"