agency-time
GET /v1/agency/time/report
Time reporting for a period, by person, client and project.
प्रमाणीकरण
एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। यो इन्डपोइन्टले विशिष्ट अनुमति खुलाएको छैन, त्यसैले अनुमान गर्नुको सट्टा आफ्नो कुञ्जीलाई आवश्यक पर्ने न्यूनतम अधिकार दिनुहोस् र प्रतिक्रिया जाँच गर्नुहोस्।
तपाईंको संस्थाको आइडी राख्ने ठाउँ
यो इन्डपोइन्टले org_id लाई क्वेरी प्यारामिटरको रूपमा लिन्छ। यसलाई छुटाउनुभयो भने कलले तपाईंको सम्पूर्ण टेनेन्सी सबट्रीलाई समेट्छ; यसलाई एउटा संस्थामा मात्र सीमित गर्न पठाउनुहोस्।
तपाईंको संस्थाको आइडी (ID) तपाईंको ड्यासबोर्डमा रहेको API कुञ्जीहरू (keys) स्क्रिनमा, कुञ्जीको छेउमा हुन्छ। तपाईंले गर्ने प्रत्येक कलमा यही आइडी प्रयोग हुन्छ।
प्रयास गर्नुहोस्
कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।
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