agency-time
GET /v1/agency/time/report
Time reporting for a period, by person, client and project.
احراز هویت
یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمیکند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.
جایی که شناسه سازمان شما قرار میگیرد
این نقطه پایانی org_id را به عنوان یک پارامتر پرسوجو میپذیرد. آن را رها کنید تا فراخوانی کل زیردرخت اجارهای شما را پوشش دهد؛ آن را ارسال کنید تا فراخوانی به یک سازمان محدود شود.
شناسه سازمان شما در صفحه کلیدهای API در داشبوردتان، در کنار خود کلید قرار دارد. این شناسه در تمام درخواستهایی که ارسال میکنید یکسان است.
امتحان کنید
هر چیزی را که داخل براکتهای زاویهدار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.
curl -X GET https://api.zinndigital.com/v1/agency/time/report \
-H "Authorization: Bearer zdk_live_…"وارد شدهاید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر میکند و درخواست را روی API زنده اجرا میکند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید
جزئیات
⛔ **Unbilled, unpriced and non-billable are three different things and this says which.** Collapsing them is how an agency loses money quietly: hours with no rate card and hours marked internal both contribute nothing to revenue, but one is money about to be lost and the other is a decision they made. `billable_minutes` is the total minus non-billable — *not* "billed". An hour logged as billable and not yet invoiced is billable work, and calling it anything else is how an agency talks itself out of chasing it.
پارامترها
| نام | نوع | الزامی | چیست |
|---|---|---|---|
org_id (query) | string | خیر | — |
from (query) | string | خیر | Defaults to the first of the current month. |
to (query) | string | خیر | Defaults to today. |
client_id (query) | string | خیر | — |
user_id (query) | string | خیر | — |
پاسخ
| نام | نوع | الزامی | چیست |
|---|---|---|---|
period_start | string | بله | — |
period_end | string | بله | — |
total_minutes | integer | بله | — |
billable_minutes | integer | خیر | Total minus NON-BILLABLE — ⛔ not "billed". An hour logged as billable and not yet invoiced is billable work, and calling it anything else is how an agency talks itself out of ch… |
billed_minutes | integer | بله | — |
unbilled_minutes | integer | بله | — |
non_billable_minutes | integer | بله | — |
billed_minor_by_currency | object | خیر | — |
by_user | TimeReportBucket[] | خیر | — |
by_client | TimeReportBucket[] | خیر | — |
by_project | TimeReportBucket[] | خیر | — |
خطاهایی که این نقطه پایانی میتواند برگرداند
401 · 403 · 422