CompuDime API docs

Reference / Schemas

MeResponse

Who the calling key is: its display prefix, mode (live or test) and kind (genie for cd_ keys, compuconnect for cc_ keys); its integration (capability, access level, billing class); its store; for each resource the key can read, the fields it may request and the ones an omitted fields returns; its per-key rate limit; and, for the store's own keys, the store's credits for the month, as GET /v1/usage/current reports them without the per-endpoint breakdown. A key your organization holds for a store (a developer's key under the owner's approval, for instance) never sees the store's plan or credits: credits is left out, creditsNote says its calls are billed to your organization (or to the store, when the owner chose to pay), and usageUrl links your organization's usage at https://account.compudime.com/usage. Never the key itself. When billing cannot be read the answer is still 200, with credits left out and creditsNote saying so. Free; a good first call.

Type: object.

NameTypeDescription
fieldPolicy requiredobjectOne entry per resource the key can read today, listing the operations that read it with exactly these fields. fields is every name the key may put in fields (fields=* returns all of them except namedOnlyFields); defaultFields is what an omitted fields returns under today's pricing; namedOnlyFields are sensitive fields the store owner granted this integration, returned only when the request names them. source policy: the integration's pinned field policy (policyId) decides the fields; source catalog: the resource's published field catalog does. Empty when the store has not enabled the key's capability (GET /v1/capabilities).
fieldPolicy.policyId requiredstringThe integration's pinned field policy.
fieldPolicy.resources requiredarray of object
fieldPolicy.resources[].defaultFields requiredarray of stringWhat an omitted fields returns today.
fieldPolicy.resources[].endpoints requiredarray of stringThe operation ids that read the resource with these fields.
fieldPolicy.resources[].fields requiredarray of stringEvery name the key may request.
fieldPolicy.resources[].resource requiredstringThe field catalog id (x-compudime-field-catalog.resource on the operations).
fieldPolicy.resources[].source requiredstringpolicy: the pinned field policy decides the fields; catalog: the resource's published field catalog does. One of: policy, catalog.
fieldPolicy.resources[].namedOnlyFieldsarray of stringSensitive fields granted to this integration, returned only when named.
fieldPolicy.version requiredintegerThe pinned policy's version, as fieldPolicyVersion on the product answers.
fieldPolicy.rowScopearray of objectThe pinned row scope: the rows the key is limited to on the reads that honour it (see the Scoped API keys guide). Absent: every row of the store.
fieldPolicy.rowScope[].fieldstring
fieldPolicy.rowScope[].opstring One of: eq, in, prefix.
fieldPolicy.rowScope[].valuesarray of string
integration requiredobject
integration.accessLevel requiredstringThe integration's access level, as GET /v1/capabilities returns it. One of: own, all.
integration.billingClass requiredstringhouse: a CompuDime-owned integration, metered at zero (priceSource house); charged: every other integration. One of: charged, house.
integration.capabilities requiredarray of stringThe capabilities the key carries: capabilityId for a cd_ key; for a cc_ key every capability CompuConnect lists for it (other CompuDime APIs' included).
integration.capabilityId requiredstringThe capability this integration reads under.
integration.displayName requiredstring
integration.integrationId requiredstringThe integration the key reads through; problem bodies name it too.
integration.notestringPresent on a cc_ key that carries more than one Public API capability: each reads through an integration of its own, and this answer describes the one named in capabilityId.
key requiredobject
key.kind requiredstringgenie for a cd_ key, compuconnect for a cc_ key (issued at account.compudime.com). One of: genie, compuconnect.
key.mode requiredstringtest: the key's calls draw on the monthly sandbox allowance of the organization that pays for them and are never charged; live: they are billed to that organization's plan (the store's, or a developer's under a store approval). One of: live, test.
key.prefix requiredstringThe key's display prefix (cd_live_, cd_test_, or the first 12 characters of a cc_ key), as the console and the request logs show it. Never more of the key.
key.notestringPresent on a test key: its calls are never charged.
requestId requiredstring
store requiredobject
store.displayName requiredstring
store.storeId requiredstring
store.sandboxbooleantrue when the key's store is the demo store (CompuDime Demo Market): its data is invented, only test keys may call it, and it is never billed. Absent for a real store.
creditsUsageSummary
creditsNotestringPresent when credits is absent, and says why: the store's credits could not be read (the rest of the answer is current), the store is the demo store, or the key is held by your organization rather than the store, so its calls are billed to your organization (or to the store, when its owner chose to pay) and the store's plan and credits are not shown to it.
rateLimitobjectThe per-key limit every authenticated call passes, free ones included (see Rate limits). Billed calls are also held to the store plan's own per-minute ceiling.
rateLimit.burstinteger
rateLimit.requestsPerMinuteinteger
usageUrlstringPresent on a key your organization holds for a store: where your organization's own usage is, https://account.compudime.com/usage.

Other fields can appear later. Ignore the ones you do not know.

Used by