🗃️Endpoints - Les canaux

Créer un canal

post

Create a channel

Corps

namestringRequis

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanRequis

Whether the channel should be auto-joined by new members.

showMembersbooleanRequis

Whether the channel should show its members.

privacystring · enumRequis

Privacy setting of the channel

Valeurs possibles:

Réponses

201

Channel has been successfully created

application/json

400

Malformed payload

post

HTTPcURLJavaScriptPython

POST /v1/channels HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "name": "text",
  "description": "text",
  "emoji": "text",
  "autoJoin": true,
  "showMembers": true,
  "privacy": "Private"
}

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Lister les canaux du Spot

get

List channels

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

Réponses

200

Channels returned successfully

application/json

400

Malformed payload

get

HTTPcURLJavaScriptPython

GET /v1/channels HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text",
      "description": {},
      "privacy": "Private",
      "autoJoin": true,
      "showMembers": true
    }
  ],
  "total": 1
}

Lister les membres d'un canal

get

List Channel members

Paramètres de chemin

channelIdstringRequis

The id of the channel

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

email[in]string[]Optionnel

The emails of spot member to include in the result

firstname[in]string[]Optionnel

The firstnames of spot member to include in the result

lastname[in]string[]Optionnel

The lastnames of spot member to include in the result

registrationDate[before]integerOptionnel

Spot members where registration date is before a specific date (Unix timestamp format)

registrationDate[after]integerOptionnel

Spot members where registration date is after a specific date (Unix timestamp format)

Réponses

200

Channel members returned successfully

application/json

400

Malformed payload

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId}/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "spotId": "text",
      "userId": "text",
      "email": "text",
      "title": "text",
      "role": "Member",
      "customRoleId": "text",
      "status": "Accepted",
      "firstname": "text",
      "lastname": "text",
      "warnings": 1,
      "embedBaseUrls": {
        "default": "text",
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "total": 1
}

Ajouter un membre à un canal

post

Add member to a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdstringRequis

An uuid representing the unique identifier of the spot member to add to channel

Réponses

204

Member successfully added

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "spotMemberId": "text"
}

Aucun contenu

Supprimer un canal

delete

Delete a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Réponses

204

Channel successfully deleted

400

Malformed payload

404

Channel not found

delete

HTTPcURLJavaScriptPython

DELETE /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

Modifier un canal

put

Update a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

namestringOptionnel

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanOptionnel

Whether the channel should be auto-joined by new members.

showMembersbooleanOptionnel

Whether the channel should show its members.

privacystring · enumOptionnel

Privacy setting of the channel

Valeurs possibles:

Réponses

200

Channel successfully updated

application/json

400

Malformed payload

404

Channel not found

put

HTTPcURLJavaScriptPython

PUT /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "name": "text",
  "description": "text",
  "emoji": "text",
  "autoJoin": true,
  "showMembers": true,
  "privacy": "Private"
}

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Récupérer un canal

get

Get a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Réponses

200

Channel found and returned successfully

application/json

400

Malformed payload

404

Channel not found

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "id": "text",
  "name": "text",
  "emoji": "text",
  "description": {},
  "privacy": "Private",
  "autoJoin": true,
  "showMembers": true
}

Ajouter plusieurs membres à un canal

post

Add members to a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdsstring[]Requis

An array of strings representing the unique identifiers of spot members to add to channel

Réponses

200

Members successfully added

application/json

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers~bulkAdd HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "spotMemberIds": [
    "text"
  ]
}

{
  "addedSpotMemberIds": [
    "text"
  ],
  "failedSpotMemberIds": [
    "text"
  ]
}

Supprimer plusieurs membres d'un canal

post

Remove members from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

spotMemberIdsstring[]Requis

An array of strings representing the unique identifiers of spot members to remove from channel

Réponses

200

Members successfully removed

application/json

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/spotMembers~bulkRemove HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "spotMemberIds": [
    "text"
  ]
}

{
  "removedSpotMembersCount": 1
}

Créer plusieurs canaux

post

Create multiple channels

Corps

namestringRequis

The name of the channel.

descriptionstringOptionnel

The description of the channel

emojistringOptionnel

The emoji of the channel

autoJoinbooleanRequis

Whether the channel should be auto-joined by new members.

showMembersbooleanRequis

Whether the channel should show its members.

privacystring · enumRequis

Privacy setting of the channel

Valeurs possibles:

Réponses

201

Channels has been successfully created

application/json

400

Malformed payload

413

Payload is too large

post

HTTPcURLJavaScriptPython

POST /v1/channels~bulkCreate HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 108

[
  {
    "name": "text",
    "description": "text",
    "emoji": "text",
    "autoJoin": true,
    "showMembers": true,
    "privacy": "Private"
  }
]

{
  "created": [
    {
      "id": "text",
      "name": "text",
      "emoji": "text",
      "description": {},
      "privacy": "Private",
      "autoJoin": true,
      "showMembers": true
    }
  ],
  "failed": [
    {
      "name": "text",
      "description": "text",
      "emoji": "text",
      "autoJoin": true,
      "showMembers": true,
      "privacy": "Private"
    }
  ]
}

Associer un groupe à un canal

post

Link a group

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdstringRequis

The id of the group to link

Réponses

204

Group linked successfully

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "groupId": "text"
}

Aucun contenu

Lister les groupes d'un canal

get

list a group

Paramètres de chemin

channelIdstringRequis

The id of the channel

Paramètres de requête

pageinteger | nullableOptionnel

The page number in a paginated set of results

limitinteger | nullableOptionnel

The limit of results to be returned per page

Réponses

200

Group returned successfully

application/json

400

Malformed payload

404

Channel not found

get

HTTPcURLJavaScriptPython

GET /v1/channels/{channelId}/groups HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

{
  "items": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "emoji": "text",
      "icon": "text"
    }
  ],
  "total": 1
}

Désassocier un groupe d'un canal

delete

Unlink a group from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

groupIdstringRequis

The id of the group

Réponses

204

Group successfully unlink

400

Malformed payload

404

Channel or Group not found

delete

HTTPcURLJavaScriptPython

DELETE /v1/channels/{channelId}/groups/{groupId} HTTP/1.1
Host: openapi.meltingspot.io
Accept: */*

Aucun contenu

Associer plusieurs groupes à un canal

post

Link groups

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdsstring[]Requis

The ids of the groups to link

Réponses

204

Groups linked successfully

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups~bulkAdd HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu

Désassocier plusieurs groupes d'un canal

post

Unlink groups from a channel

Paramètres de chemin

channelIdstringRequis

The id of the channel

Corps

groupIdsstring[]Requis

The ids of the groups to link

Réponses

204

Groups successfully unlink

400

Malformed payload

404

Channel not found

post

HTTPcURLJavaScriptPython

POST /v1/channels/{channelId}/groups~bulkRemove HTTP/1.1
Host: openapi.meltingspot.io
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "groupIds": [
    "text"
  ]
}

Aucun contenu