GET /api/v1/deals/activities
Página de atividades dos negócios visíveis ao membro da chave, pela mais recente. Os filtros de tipo e ator podem ser repetidos ou separados por vírgula.
Exemplos A URL usa o servidor de produção. Defina PIPEFACIL_API_KEY e as variáveis de caminho (como SEQ ou ID) com os identificadores reais. Ajuste o corpo antes de executar: requisições de escrita alteram dados do workspace.
cURL curl --request GET \ --url "https://pipefacil-server.matchsales.com.br/api/v1/deals/activities" \ --header "Authorization: Bearer $PIPEFACIL_API_KEY " JavaScript const response = await fetch ( `https://pipefacil-server.matchsales.com.br/api/v1/deals/activities` , { method: "GET" , headers: { Authorization: `Bearer ${ process . env . PIPEFACIL_API_KEY }` , }, }); if ( ! response.ok) throw new Error ( `HTTP ${ response . status }: ${ await response . text () }` ); const text = await response. text (); const data = text ? JSON . parse (text) : null ; Python import os import json import requests response = requests.request( "GET" , f "https://pipefacil-server.matchsales.com.br/api/v1/deals/activities" , headers = { "Authorization" : f "Bearer { os.environ[ 'PIPEFACIL_API_KEY' ] } " }, ) response.raise_for_status() data = response.json() if response.content else None Parâmetros Nome Local Tipo Obrigatório Descrição typequeryarray de stringNão Filtro de tipo de atividade; pode ser repetido. actorTypequeryarray de stringNão Filtro de tipo de autor; pode ser repetido. actorUserIdquerystringNão — limitqueryintegerNão — cursorquerystringNão —
Respostas 200 Sucesso Campo Tipo Descrição dataobject— data.itemsarray— data.items[].idstring— data.items[].dealIdstring— data.items[].typestring— data.items[].fieldstringAceita null. data.items[].changesobjectAceita null. data.items[].metadataobjectAceita null. data.items[].occurredAtstringFormato: date-time. data.items[].actorobjectResumo do autor: usuário ou sistema. data.nextCursorstringAceita null. data.hasMoreboolean— messagestringAceita null.
Esquema OpenAPI { "type" : "object" , "properties" : { "data" : { "type" : "object" , "properties" : { "items" : { "type" : "array" , "items" : { "$ref" : "#/components/schemas/DealActivity" } }, "nextCursor" : { "type" : "string" , "nullable" : true }, "hasMore" : { "type" : "boolean" } } }, "message" : { "type" : "string" , "nullable" : true } } } 401 Chave ausente, malformada, desconhecida, revogada ou expirada, ou membro emissor inativo. Campo Tipo Descrição errorstring— codestringValores: BAD_REQUEST, VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, FEATURE_DISABLED, NOT_FOUND, CONFLICT, QUOTA_EXCEEDED, UNPROCESSABLE_ENTITY, INTERNAL_ERROR, SERVICE_UNAVAILABLE. requestIdstring— detailsstringAceita null. fieldErrorsarrayAceita null. fieldErrors[].fieldstring— fieldErrors[].messagestring—
Esquema OpenAPI { "type" : "object" , "description" : "Formato padrão de erro. `details` e `fieldErrors` são omitidos quando ausentes." , "properties" : { "error" : { "type" : "string" }, "code" : { "type" : "string" , "enum" : [ "BAD_REQUEST" , "VALIDATION_ERROR" , "UNAUTHORIZED" , "FORBIDDEN" , "FEATURE_DISABLED" , "NOT_FOUND" , "CONFLICT" , "QUOTA_EXCEEDED" , "UNPROCESSABLE_ENTITY" , "INTERNAL_ERROR" , "SERVICE_UNAVAILABLE" ] }, "requestId" : { "type" : "string" }, "details" : { "type" : "string" , "nullable" : true }, "fieldErrors" : { "type" : "array" , "nullable" : true , "items" : { "type" : "object" , "properties" : { "field" : { "type" : "string" }, "message" : { "type" : "string" } } } } }, "required" : [ "error" , "code" , "requestId" ] } 404 Recurso não encontrado ou fora da visibilidade do membro. Campo Tipo Descrição errorstring— codestringValores: BAD_REQUEST, VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, FEATURE_DISABLED, NOT_FOUND, CONFLICT, QUOTA_EXCEEDED, UNPROCESSABLE_ENTITY, INTERNAL_ERROR, SERVICE_UNAVAILABLE. requestIdstring— detailsstringAceita null. fieldErrorsarrayAceita null. fieldErrors[].fieldstring— fieldErrors[].messagestring—
Esquema OpenAPI { "type" : "object" , "description" : "Formato padrão de erro. `details` e `fieldErrors` são omitidos quando ausentes." , "properties" : { "error" : { "type" : "string" }, "code" : { "type" : "string" , "enum" : [ "BAD_REQUEST" , "VALIDATION_ERROR" , "UNAUTHORIZED" , "FORBIDDEN" , "FEATURE_DISABLED" , "NOT_FOUND" , "CONFLICT" , "QUOTA_EXCEEDED" , "UNPROCESSABLE_ENTITY" , "INTERNAL_ERROR" , "SERVICE_UNAVAILABLE" ] }, "requestId" : { "type" : "string" }, "details" : { "type" : "string" , "nullable" : true }, "fieldErrors" : { "type" : "array" , "nullable" : true , "items" : { "type" : "object" , "properties" : { "field" : { "type" : "string" }, "message" : { "type" : "string" } } } } }, "required" : [ "error" , "code" , "requestId" ] } 429 Limite de requisições excedido por workspace ou IP. Campo Tipo Descrição errorstring— codestringValores: BAD_REQUEST, VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, FEATURE_DISABLED, NOT_FOUND, CONFLICT, QUOTA_EXCEEDED, UNPROCESSABLE_ENTITY, INTERNAL_ERROR, SERVICE_UNAVAILABLE. requestIdstring— detailsstringAceita null. fieldErrorsarrayAceita null. fieldErrors[].fieldstring— fieldErrors[].messagestring—
Esquema OpenAPI { "type" : "object" , "description" : "Formato padrão de erro. `details` e `fieldErrors` são omitidos quando ausentes." , "properties" : { "error" : { "type" : "string" }, "code" : { "type" : "string" , "enum" : [ "BAD_REQUEST" , "VALIDATION_ERROR" , "UNAUTHORIZED" , "FORBIDDEN" , "FEATURE_DISABLED" , "NOT_FOUND" , "CONFLICT" , "QUOTA_EXCEEDED" , "UNPROCESSABLE_ENTITY" , "INTERNAL_ERROR" , "SERVICE_UNAVAILABLE" ] }, "requestId" : { "type" : "string" }, "details" : { "type" : "string" , "nullable" : true }, "fieldErrors" : { "type" : "array" , "nullable" : true , "items" : { "type" : "object" , "properties" : { "field" : { "type" : "string" }, "message" : { "type" : "string" } } } } }, "required" : [ "error" , "code" , "requestId" ] } 
