Pular para o conteúdo principal

Endpoints de Ação

Este recurso possui endpoints relacionados à atividades que você pode fazer de gerenciamento de ações de usuários dentro da Plataforma StackSpot EDP.

MétodoEndpointDescriçãoParâmetrosRespostas
GET/scim/ActionsObter todas as açõesX-Tenant-Id: string (header)200: OK
POST/scim/ActionsCriar uma ação novaX-Tenant-Id: string (header), body: Create Action201: Created
GET/scim/Actions/{id}Obter uma ação pelo idX-Tenant-Id: string (header)200: OK
PUT/scim/Actions/{id}Fazer alteração por completo do objetoX-Tenant-Id: string (header), body: Update Action (body, required, schema: domain.UpdateAction)200: OK
DELETE/scim/Actions/{id}Deletar açõesX-Tenant-Id: string (header)204: No Content
PATCH/scim/Actions/{id}Fazer alteração de forma parcial da objeto da açãoX-Tenant-Id: string (header), body: Update Action (body, required, schema: domain.ActionPatchOperation)200: OK

Definições de Resposta

domain.Action

CampoTipoObrigatório
activebooleansim
client_idstringsim
created_atstringsim
descriptionstringsim
idstringsim
namestringsim

domain.ActionAttributes

CampoTipoObrigatório
activebooleansim
client_idstringsim
created_atstringsim
descriptionstringsim
idstringsim
namestringsim

domain.ActionDomain

CampoTipoObrigatório
attributes$ref: '#/definitions/domain.ActionAttributes'sim
externalIDobject (additionalProperties: true)sim
idstringsim
meta$ref: '#/definitions/domain.Meta'sim
schemasarray of stringsim

domain.ActionPageDomain

CampoTipoObrigatório
resourcesarray of domain.ActionDomainSim
totalResultsintegerSim

domain.ActionPatchOperation

CampoTipoObrigatório
Operationsarray of object (properties: op, path, value)sim
schemasstringsim

domain.CreateAction

CampoTipoObrigatório
client_idstringNão
descriptionstringNão
namestringSim

Exemplo de resposta

GET/scim/Actions Get All Actions

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint GET/scim/Actions Get All Actions

Requisição:

GET /tenant-id/scim/Actions Get all actions

Header:
Authorization: Bearer token

Resposta:

Status-Code 200: {
Resources: [
{
"active": false,
"client_id": null,
"description": "Action Description",
"displayName": "Action Example",
"id": "19d29238-4f59-4f96-b0fd-d246fe28a218",
"meta": {
"resourceType": "Action",
"created": "2024-04-12T18:07:55Z",
"location": "Actions/19d29238-4f59-4f96-b0fd-d246fe28a218",
"version": "1"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Actions"
]
}
],
"itemsPerPage": 100,
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"startIndex": 1,
"totalResults": 50
}

POST /tenant-id/scim/Actions Create Action

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint POST /tenant-id/scim/Actions Create Action

Requisição:

POST /tenant-id/scim/Actions Create Action

Header:
Authorization: Bearer token

Resposta:

Status-Code 201: {
"active": false,
"client_id": null,
"description": "This is a test to create action",
"displayName": "scim-action-example",
"id": "e69b1a43-b85b-49b5-af5f-9f0eb3e14f4a",
"meta": {
"resourceType": "Action",
"created": "2024-05-31T12:37:41Z",
"location": "Actions/e69b1a43-b85b-49b5-af5f-9f0eb3e14f4a",
"version": "1"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Actions"
]
}

POST /tenant-id/scim/Actions Create Action

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint POST /tenant-id/scim/Actions Create Action

Requisição:

POST /tenant-id/scim/Actions Create Action

Header:
Authorization: Bearer token

Resposta:

Status-Code 201: {
"active": false,
"client_id": null,
"description": "This is a test to create action",
"displayName": "scim-action-example",
"id": "e69b1a43-b85b-49b5-af5f-9f0eb3e14f4a",
"meta": {
"resourceType": "Action",
"created": "2024-05-31T12:37:41Z",
"location": "Actions/e69b1a43-b85b-49b5-af5f-9f0eb3e14f4a",
"version": "1"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Actions"
]
}

GET /tenant-id/scim/Actions/\{id} Get Action By Id

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint GET /tenant-id/scim/Actions/\{id} Get Action By Id

Requisição:

GET /tenant-id/scim/Actions/{id} Get Action By Id

Header:
Authorization: Bearer token

Resposta:

Status-Code 200: {
"active": false,
"client_id": null,
"description": "This is a test to create action",
"displayName": "scim-action-teste-updated",
"id": "8fb5d7bd-de19-441b-98cd-ff679cced4f3",
"meta": {
"resourceType": "Action",
"created": "2024-04-30T20:30:03Z",
"location": "Actions/8fb5d7bd-de19-441b-98cd-ff679cced4f3",
"version": "1"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Actions"
]
}

PUT /tenant-id/scim/Actions/\{id} Update Action

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint PUT /tenant-id/scim/Actions/\{id} Update Action

Requisição:

PUT /tenant-id/scim/Actions/{id} Update Action

Header:
Authorization: Bearer token

Resposta:

Status-Code 200: {
"active": false,
"client_id": null,
"description": "This is a test to create action",
"displayName": "scim-action-example-updated",
"id": "8fb5d7bd-de19-441b-98cd-ff679cced4f3",
"meta": {
"resourceType": "Action",
"created": "2024-04-30T20:30:03Z",
"location": "Actions/8fb5d7bd-de19-441b-98cd-ff679cced4f3",
"version": "1"
},
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Actions"
]
}

DELETE /tenant-id/scim/Actions/\{id} Remove Action

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint DELETE /tenant-id/scim/Actions/\{id} Remove Action

Requisição:

DELETE /tenant-id/scim/Actions/\{id} Remove Action

Header:
Authorization: Bearer token

Resposta:

Status-Code 204: NO BODY RESPONSE

PATCH /tenant-id/scim/Actions/\{id} Update Action With Patch operation

Aqui você encontra um exemplo de resposta da API para uma chamada com o endpoint PATCH /tenant-id/scim/Actions/\{id} Update Action With Patch operation

Requisição:

PATCH /tenant-id/scim/Actions/\{id} Update Action With Patch operation

Header:
Authorization: Bearer token

Resposta:

Status-Code 200:{
"Operations": [
{
"op": "string",
"path": {
"attributePath": {
"attributeName": "string",
"subAttribute": "string",
"uriprefix": "string"
},
"subAttribute": "string",
"valueExpression": "string"
},
"value": {
"client_id": "string",
"description": "string",
"name": "string"
}
}
],
"schemas": "string"
}