agency-invoicing

POST `/v1/agency-invoicing/logo`

Upload the logo your invoices carry.

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění agency.invoicing.manage; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Sem patří ID vaší organizace

Tento koncový bod přijímá org_id jako parametr dotazu. Pokud ho vynecháte, volání pokryje celý podstrom vašeho nájemce; jeho odesláním volání zúžíte na jednu organizaci.

ID vaší organizace najdete na obrazovce API klíčů ve vašem přehledu, hned vedle samotného klíče. Je to stále stejné ID v každém volání, které provedete.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/agency-invoicing/logo \
  -H "Authorization: Bearer zdk_live_…"

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

⛔ Its own door, and `POST /v1/branding/logo` cannot serve it: that one stores the mark for a white-labelled **panel**, demands `reseller.manage`, and refuses unless white-label is on the plan — with the message *"a logo here would appear nowhere"*. On a panel that is right. On an invoice it is false: the document is your own paper and carries your mark whatever your plan says. ⭐ The image is vetted and stored content-addressed; the digest returned is what the PDF inlines as a `data:` URI, which is what keeps the render offline. Requires `agency.invoicing.manage`.

Parametry

Název	Typ	Požadováno	Co to je
`org_id (query)`	`Uuid`	Ne	Which of your organizations is invoicing. Required only when you belong to more than one — otherwise it is inferred from your DIRECT membership, never from the subtree-expanded…

Odpověď

Název	Typ	Požadováno	Co to je
`logo_sha256`	`string`	Ano	The content digest. ⛔ Not a URL — the invoice renderer inlines the bytes as a `data:` URI and follows no external reference at render time.
`width`	`integer`	Ne	—
`height`	`integer`	Ne	—
`byte_size`	`integer`	Ne	—

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422 · 429