مرجع API

مذاکرات

مذاکرات قیف فروش، با ارزش، ارز و مرحله.

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"
  }
}

مثال گویا

قبلیمنجر می شود بعدیاشیاء