مرجع واجهة برمجة التطبيقات
المفاوضات
مفاوضات مسار المبيعات، مع القيمة والعملة والمرحلة.
Listar negociações
get/api/v1/deals
إذن المفتاح: leitura
حدود
limit integer · consulta
الافتراضي: 50 · Máximo: 200
cursor string · consulta
next_cursor da página anterior
updated_since string (date-time) · consulta
—
status string · consulta
—
الإجابات
- 200صفحة
طلب
curl "https://www.cyzyra.com/api/v1/deals" \
-H "Authorization: Bearer $CYZYRA_API_KEY"إجابة
{
"data": [
{
"id": "c21a…",
"title": "Plano anual",
"value": 1500,
"currency": "BRL"
}
],
"next_cursor": null
}說明性範例。
Criar negociação
post/api/v1/deals
إذن المفتاح: escrita
الجسم (JSON)
lead_id string (uuid)إلزامي
—
title stringإلزامي
—
value numberإلزامي
—
currency string
الافتراضي: BRL
stage string
—
expected_close_at string (date)
—
الإجابات
- 201Criada
طلب
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"}'إجابة
{
"data": {
"id": "c21a…",
"title": "Plano anual",
"value": 1500,
"currency": "BRL"
}
}說明性範例。
