Riferimento API
Negoziati
Negoziazioni del funnel di vendita, con valore, valuta e fase.
Listar negociações
get/api/v1/deals
Autorizzazione chiave: leitura
Parametri
limit integer · consulta
Predefinito: 50 · Máximo: 200
cursor string · consulta
next_cursor da página anterior
updated_since string (date-time) · consulta
—
status string · consulta
—
Risposte
- 200Pagina
Richiesta
curl "https://www.cyzyra.com/api/v1/deals" \
-H "Authorization: Bearer $CYZYRA_API_KEY"Risposta
{
"data": [
{
"id": "c21a…",
"title": "Plano anual",
"value": 1500,
"currency": "BRL"
}
],
"next_cursor": null
}Illustratief voorbeeld.
Criar negociação
post/api/v1/deals
Autorizzazione chiave: escrita
Corpo (JSON)
lead_id string (uuid)obbligatorio
—
title stringobbligatorio
—
value numberobbligatorio
—
currency string
Predefinito: BRL
stage string
—
expected_close_at string (date)
—
Risposte
- 201Criada
Richiesta
curl -X POST "https://www.cyzyra.com/api/v1/deals" \
-H "Authorization: Bearer $CYZYRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lead_id":"LEAD_ID","title":"Plano anual","value":1500,"currency":"BRL"}'Risposta
{
"data": {
"id": "c21a…",
"title": "Plano anual",
"value": 1500,
"currency": "BRL"
}
}Illustratief voorbeeld.
