GET
Obtenir un embut per ID
Scope:
crm:funnels.readhttps://api.holded.com/api/v2/funnels/{funnelId}Recupera els detalls d'un embut específic pel seu identificador únic.
Paràmetres
Paràmetres de ruta
funnelId
stringobligatoriID de l'embut (ObjectId hexadecimal de 24 caràcters)
Petició
python
import requests
url = "https://api.holded.com/api/v2/funnels/{funnelId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respostes
Resposta
json
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"stages": [
{
"id": "507f1f77bcf86cd799439011",
"name": "string",
"key": "string",
"description": "string",
"deal_probability": 0,
"rotting_days": 0
}
],
"labels": [
{}
],
"created_at": "string",
"updated_at": "string"
}Respostes exitoses
200Embut trobatapplication/jsonobject
idstringrequired
Unique identifier
namestringrequired
Funnel name
stages[]object[]required
Funnel stages
idstring
namestring
keystring
descriptionstring
deal_probabilityinteger
rotting_daysinteger
labels[]object[]required
Funnel labels
created_atstring | nullrequired
Creation date in ISO 8601 format
updated_atstring | nullrequired
Last update date in ISO 8601 format
Respostes d'error
401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Embut no trobatapplication/json429Límit de sol·licituds exceditapplication/json