agency-time
GET /v1/agency/time/unbilled
What is outstanding, per client and currency.
認証
ベアラー トークンとして API キーを送信します。このエンドポイントでは仕様に特定の権限が記載されていないため、キーに必要な最小限の権限を付与し、推測するのではなくレスポンスを確認してください。
組織 ID を入力する場所
このエンドポイントはクエリパラメータとして org_id を受け取ります。省略した場合はテナントサブツリー全体が対象になり、指定した場合は特定の組織のみに絞り込まれます。
組織IDは、ダッシュボードのAPIキー画面にキーのすぐ横に表示されています。これは、実行するすべての呼び出しで同じIDになります。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X GET https://api.zinndigital.com/v1/agency/time/unbilled \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
The **same** figure a threshold trigger fires on — one function, deliberately, because two implementations of "how much is outstanding" is how a client is shown £900 and invoiced £1,100. `unpriced_minutes` is reported separately from the money: hours logged against work with no rate card are not worth zero, they are unpriced, and an agency that cannot see them will not fix them. `can_bill` says whether the invoicing suite is reachable at all, so the console never offers a Bill-now button that can only refuse.
パラメータ
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
org_id (query) | string | いいえ | — |
client_id (query) | string | いいえ | — |
until (query) | string | いいえ | Only count work up to and including this date. |
返信
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
data | UnbilledBucket[] | はい | — |
can_bill | boolean | はい | Whether the agency invoicing suite is reachable at all. Told to the console rather than discovered by pressing the button, so it never offers a Bill-now that can only refuse. |
このエンドポイントが返すエラー
401 · 403 · 422