Introduction to Remizen APIs — Proposed Guide
Planned API — Reference OnlyIntroduction to Remizen APIs: The proposed developer surface organizes employee, expense and accounting information around an organization boundary. Start…
Overview
The proposed developer surface organizes employee, expense and accounting information around an organization boundary. Start by identifying which records a future application needs, rather than requesting access to every financial workflow.
Key concepts
Separate reading a record from authorizing a business decision. An expense resource, an approval decision and a reimbursement are different objects with different owners.
Implementation considerations
Document the organization owner, minimum data requirements and intended retention before designing a client. None of the illustrated services is available today.
Illustrative data model
This local fixture shows a possible representation for the concepts above. It is not an endpoint response, production configuration or a claim that the described capability is implemented.
{
"reference_only": true,
"topic": "Introduction to Remizen APIs",
"organization_id": "org_example_123",
"resource_type": "expense",
"scope": [
"expenses:read"
]
}Design review checklist
- Document which organization owns the introduction to remizen apis representation and which actor may view or change it.
- Test the boundaries of organization id, resource type, scope using synthetic values, including missing or inconsistent references.
- Before future implementation, obtain an approved contract and review failure behavior. This documentation does not authorize production activation.
Proposed data types
| Name | Type | Description |
|---|---|---|
| organization_id | string | Stable fictional organization reference; not a secret and not evidence that a resource exists. |
| resource_type | string | Type namespace for interpreting a resource identifier and its authorized actions. |
| scope | array<string> | Illustrative minimum-access grant names, not issued or finalized production scopes. |