IRPCWOPIOperations.GetWOPIDiscoveryData
Server integration API / specialized internal: not for applications read session idempotent
Gets the Office for the web actions (action name and URL) that the vault's WOPI configuration provides.
| Service | WOPI operations MFiles.IRPCWOPIOperations |
|---|---|
| gRPC method | /MFiles.IRPCWOPIOperations/GetWOPIDiscoveryData |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-wopidiscovery-data |
| Request | GetWOPIDiscoveryDataRequest |
| Response | GetWOPIDiscoveryDataResponse |
| Book and level | Server integration API, specialized |
| Kind | read |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
For M-Files components only. M-Files Web and M-Files Desktop call it to decide which files can be opened in Office for the web. Applications should not call it.
- Requires a vault session. Read-only; the server serves the data from a cache that it fills from the Office for the web discovery URL configured for the vault.
- Fails with "Not found. (Either WOPI is not enabled or the discovery URL is empty.)" when the vault has no WOPI configuration.
- Returns an empty list on a server where the WOPI service is turned off.
Request: GetWOPIDiscoveryDataRequest
A structure that specifies get WOPI discovery data request.
No fields.
Response: GetWOPIDiscoveryDataResponse
Struct for WOPI discovery data response.
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
values[] | repeated WOPIDiscovery | One entry per action: action_name and the action_url template from the discovery data. |
values[].action_name | string | The action name. |
values[].action_url | string | The action URL. |