|
1 | 1 | # permify-java |
2 | | -Permify Java Client |
| 2 | +Java Client for Permify which is an open source authorization service for creating fine-grained and scalable authorization systems. |
| 3 | + |
| 4 | +This Java package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project. |
| 5 | + |
| 6 | +## Requirements. |
| 7 | + |
| 8 | +- Java |
| 9 | +- Gradle or Maven |
| 10 | + |
| 11 | + |
| 12 | +### Installation |
| 13 | + |
| 14 | +To include the SDK in your project, add the following to your `build.gradle` file: |
| 15 | + |
| 16 | +```groovy |
| 17 | +dependencies { |
| 18 | + implementation 'co.permify:permify:{version}' |
| 19 | +} |
| 20 | +``` |
| 21 | + or add the following dependency to your `pom.xml` file: |
| 22 | + |
| 23 | +```xml |
| 24 | +<dependency> |
| 25 | + <groupId>co.permify</groupId> |
| 26 | + <artifactId>permify</artifactId> |
| 27 | + <version>{version}</version> |
| 28 | +</dependency> |
| 29 | +``` |
| 30 | + |
| 31 | + |
| 32 | +Navigate to the root directory of the project and run the following commands to build and install the SDK: |
| 33 | + |
| 34 | +```sh |
| 35 | +mvn clean install |
| 36 | +``` |
| 37 | + |
| 38 | +### Running the Application |
| 39 | + |
| 40 | +After successfully building the project, you can run the application using the following command: |
| 41 | + |
| 42 | +```sh |
| 43 | +java -jar target/your-artifact-name-0.0.1.jar |
| 44 | +``` |
| 45 | + |
| 46 | +Replace your-artifact-name-0.0.1.jar with the actual name of the jar file generated after the build. |
| 47 | + |
| 48 | +### Samples |
| 49 | + |
| 50 | +For more detailed examples, please refer to the [samples folder](https://github.com/Permify/permify-java/tree/master/samples). |
| 51 | + |
| 52 | +## Documentation for API Endpoints |
| 53 | + |
| 54 | +All URIs are relative to *http://localhost:3476* |
| 55 | + |
| 56 | +Class | Method | HTTP request | Description |
| 57 | +------------ | ------------- | ------------- | ------------- |
| 58 | +*BundleApi* | [**bundle_delete**](docs/BundleApi.md#bundle_delete) | **POST** /v1/tenants/{tenant_id}/bundle/delete | delete bundle |
| 59 | +*BundleApi* | [**bundle_read**](docs/BundleApi.md#bundle_read) | **POST** /v1/tenants/{tenant_id}/bundle/read | read bundle |
| 60 | +*BundleApi* | [**bundle_write**](docs/BundleApi.md#bundle_write) | **POST** /v1/tenants/{tenant_id}/bundle/write | write bundle |
| 61 | +*DataApi* | [**bundle_run**](docs/DataApi.md#bundle_run) | **POST** /v1/tenants/{tenant_id}/data/run-bundle | run bundle |
| 62 | +*DataApi* | [**data_attributes_read**](docs/DataApi.md#data_attributes_read) | **POST** /v1/tenants/{tenant_id}/data/attributes/read | read attributes |
| 63 | +*DataApi* | [**data_delete**](docs/DataApi.md#data_delete) | **POST** /v1/tenants/{tenant_id}/data/delete | delete data |
| 64 | +*DataApi* | [**data_relationships_read**](docs/DataApi.md#data_relationships_read) | **POST** /v1/tenants/{tenant_id}/data/relationships/read | read relationships |
| 65 | +*DataApi* | [**data_write**](docs/DataApi.md#data_write) | **POST** /v1/tenants/{tenant_id}/data/write | write data |
| 66 | +*DataApi* | [**relationships_delete**](docs/DataApi.md#relationships_delete) | **POST** /v1/tenants/{tenant_id}/relationships/delete | delete relationships |
| 67 | +*DataApi* | [**relationships_write**](docs/DataApi.md#relationships_write) | **POST** /v1/tenants/{tenant_id}/relationships/write | write relationships |
| 68 | +*PermissionApi* | [**permissions_check**](docs/PermissionApi.md#permissions_check) | **POST** /v1/tenants/{tenant_id}/permissions/check | check api |
| 69 | +*PermissionApi* | [**permissions_expand**](docs/PermissionApi.md#permissions_expand) | **POST** /v1/tenants/{tenant_id}/permissions/expand | expand api |
| 70 | +*PermissionApi* | [**permissions_lookup_entity**](docs/PermissionApi.md#permissions_lookup_entity) | **POST** /v1/tenants/{tenant_id}/permissions/lookup-entity | lookup entity |
| 71 | +*PermissionApi* | [**permissions_lookup_entity_stream**](docs/PermissionApi.md#permissions_lookup_entity_stream) | **POST** /v1/tenants/{tenant_id}/permissions/lookup-entity-stream | lookup entity stream |
| 72 | +*PermissionApi* | [**permissions_lookup_subject**](docs/PermissionApi.md#permissions_lookup_subject) | **POST** /v1/tenants/{tenant_id}/permissions/lookup-subject | lookup-subject |
| 73 | +*PermissionApi* | [**permissions_subject_permission**](docs/PermissionApi.md#permissions_subject_permission) | **POST** /v1/tenants/{tenant_id}/permissions/subject-permission | subject permission |
| 74 | +*SchemaApi* | [**schemas_list**](docs/SchemaApi.md#schemas_list) | **POST** /v1/tenants/{tenant_id}/schemas/list | list schema |
| 75 | +*SchemaApi* | [**schemas_partial_write**](docs/SchemaApi.md#schemas_partial_write) | **PATCH** /v1/tenants/{tenant_id}/schemas/partial-write | partially update your authorization model |
| 76 | +*SchemaApi* | [**schemas_read**](docs/SchemaApi.md#schemas_read) | **POST** /v1/tenants/{tenant_id}/schemas/read | read schema |
| 77 | +*SchemaApi* | [**schemas_write**](docs/SchemaApi.md#schemas_write) | **POST** /v1/tenants/{tenant_id}/schemas/write | write schema |
| 78 | +*TenancyApi* | [**tenants_create**](docs/TenancyApi.md#tenants_create) | **POST** /v1/tenants/create | create tenant |
| 79 | +*TenancyApi* | [**tenants_delete**](docs/TenancyApi.md#tenants_delete) | **DELETE** /v1/tenants/{id} | delete tenant |
| 80 | +*TenancyApi* | [**tenants_list**](docs/TenancyApi.md#tenants_list) | **POST** /v1/tenants/list | list tenants |
| 81 | +*WatchApi* | [**watch_watch**](docs/WatchApi.md#watch_watch) | **POST** /v1/tenants/{tenant_id}/watch | watch changes |
| 82 | + |
| 83 | +## Documentation For Models |
| 84 | + |
| 85 | + - [AbstractType](docs/AbstractType.md) |
| 86 | + - [Any](docs/Any.md) |
| 87 | + - [Argument](docs/Argument.md) |
| 88 | + - [Attribute](docs/Attribute.md) |
| 89 | + - [AttributeDefinition](docs/AttributeDefinition.md) |
| 90 | + - [AttributeFilter](docs/AttributeFilter.md) |
| 91 | + - [AttributeReadRequestMetadata](docs/AttributeReadRequestMetadata.md) |
| 92 | + - [AttributeReadResponse](docs/AttributeReadResponse.md) |
| 93 | + - [AttributeType](docs/AttributeType.md) |
| 94 | + - [BundleDeleteBody](docs/BundleDeleteBody.md) |
| 95 | + - [BundleDeleteResponse](docs/BundleDeleteResponse.md) |
| 96 | + - [BundleReadBody](docs/BundleReadBody.md) |
| 97 | + - [BundleReadResponse](docs/BundleReadResponse.md) |
| 98 | + - [BundleRunResponse](docs/BundleRunResponse.md) |
| 99 | + - [BundleWriteBody](docs/BundleWriteBody.md) |
| 100 | + - [BundleWriteResponse](docs/BundleWriteResponse.md) |
| 101 | + - [CheckBody](docs/CheckBody.md) |
| 102 | + - [CheckResult](docs/CheckResult.md) |
| 103 | + - [CheckedExpr](docs/CheckedExpr.md) |
| 104 | + - [Child](docs/Child.md) |
| 105 | + - [Comprehension](docs/Comprehension.md) |
| 106 | + - [ComputedAttribute](docs/ComputedAttribute.md) |
| 107 | + - [ComputedUserSet](docs/ComputedUserSet.md) |
| 108 | + - [Constant](docs/Constant.md) |
| 109 | + - [Context](docs/Context.md) |
| 110 | + - [ContextAttribute](docs/ContextAttribute.md) |
| 111 | + - [CreateList](docs/CreateList.md) |
| 112 | + - [CreateStruct](docs/CreateStruct.md) |
| 113 | + - [DataBundle](docs/DataBundle.md) |
| 114 | + - [DataChange](docs/DataChange.md) |
| 115 | + - [DataChangeOperation](docs/DataChangeOperation.md) |
| 116 | + - [DataChanges](docs/DataChanges.md) |
| 117 | + - [DataDeleteBody](docs/DataDeleteBody.md) |
| 118 | + - [DataDeleteResponse](docs/DataDeleteResponse.md) |
| 119 | + - [DataWriteBody](docs/DataWriteBody.md) |
| 120 | + - [DataWriteRequestMetadata](docs/DataWriteRequestMetadata.md) |
| 121 | + - [DataWriteResponse](docs/DataWriteResponse.md) |
| 122 | + - [DeleteRelationshipsBody](docs/DeleteRelationshipsBody.md) |
| 123 | + - [Entity](docs/Entity.md) |
| 124 | + - [EntityDefinition](docs/EntityDefinition.md) |
| 125 | + - [EntityDefinitionReference](docs/EntityDefinitionReference.md) |
| 126 | + - [EntityFilter](docs/EntityFilter.md) |
| 127 | + - [Entry](docs/Entry.md) |
| 128 | + - [ExpandLeaf](docs/ExpandLeaf.md) |
| 129 | + - [ExpandTreeNode](docs/ExpandTreeNode.md) |
| 130 | + - [ExpandTreeNodeOperation](docs/ExpandTreeNodeOperation.md) |
| 131 | + - [Expr](docs/Expr.md) |
| 132 | + - [ExprCall](docs/ExprCall.md) |
| 133 | + - [FunctionType](docs/FunctionType.md) |
| 134 | + - [Ident](docs/Ident.md) |
| 135 | + - [Leaf](docs/Leaf.md) |
| 136 | + - [ListType](docs/ListType.md) |
| 137 | + - [LookupEntityBody](docs/LookupEntityBody.md) |
| 138 | + - [LookupEntityStreamBody](docs/LookupEntityStreamBody.md) |
| 139 | + - [LookupSubjectBody](docs/LookupSubjectBody.md) |
| 140 | + - [MapType](docs/MapType.md) |
| 141 | + - [PartialWriteBody](docs/PartialWriteBody.md) |
| 142 | + - [Partials](docs/Partials.md) |
| 143 | + - [PermissionCheckRequestMetadata](docs/PermissionCheckRequestMetadata.md) |
| 144 | + - [PermissionCheckResponse](docs/PermissionCheckResponse.md) |
| 145 | + - [PermissionCheckResponseMetadata](docs/PermissionCheckResponseMetadata.md) |
| 146 | + - [PermissionDefinition](docs/PermissionDefinition.md) |
| 147 | + - [PermissionExpandBody](docs/PermissionExpandBody.md) |
| 148 | + - [PermissionExpandRequestMetadata](docs/PermissionExpandRequestMetadata.md) |
| 149 | + - [PermissionExpandResponse](docs/PermissionExpandResponse.md) |
| 150 | + - [PermissionLookupEntityRequestMetadata](docs/PermissionLookupEntityRequestMetadata.md) |
| 151 | + - [PermissionLookupEntityResponse](docs/PermissionLookupEntityResponse.md) |
| 152 | + - [PermissionLookupEntityStreamResponse](docs/PermissionLookupEntityStreamResponse.md) |
| 153 | + - [PermissionLookupSubjectRequestMetadata](docs/PermissionLookupSubjectRequestMetadata.md) |
| 154 | + - [PermissionLookupSubjectResponse](docs/PermissionLookupSubjectResponse.md) |
| 155 | + - [PermissionSubjectPermissionRequestMetadata](docs/PermissionSubjectPermissionRequestMetadata.md) |
| 156 | + - [PermissionSubjectPermissionResponse](docs/PermissionSubjectPermissionResponse.md) |
| 157 | + - [PrimitiveType](docs/PrimitiveType.md) |
| 158 | + - [ReadAttributesBody](docs/ReadAttributesBody.md) |
| 159 | + - [ReadRelationshipsBody](docs/ReadRelationshipsBody.md) |
| 160 | + - [RelationDefinition](docs/RelationDefinition.md) |
| 161 | + - [RelationReference](docs/RelationReference.md) |
| 162 | + - [RelationshipDeleteResponse](docs/RelationshipDeleteResponse.md) |
| 163 | + - [RelationshipReadRequestMetadata](docs/RelationshipReadRequestMetadata.md) |
| 164 | + - [RelationshipReadResponse](docs/RelationshipReadResponse.md) |
| 165 | + - [RelationshipWriteRequestMetadata](docs/RelationshipWriteRequestMetadata.md) |
| 166 | + - [RelationshipWriteResponse](docs/RelationshipWriteResponse.md) |
| 167 | + - [Rewrite](docs/Rewrite.md) |
| 168 | + - [RewriteOperation](docs/RewriteOperation.md) |
| 169 | + - [RuleDefinition](docs/RuleDefinition.md) |
| 170 | + - [RunBundleBody](docs/RunBundleBody.md) |
| 171 | + - [SchemaDefinition](docs/SchemaDefinition.md) |
| 172 | + - [SchemaDefinitionReference](docs/SchemaDefinitionReference.md) |
| 173 | + - [SchemaList](docs/SchemaList.md) |
| 174 | + - [SchemaListBody](docs/SchemaListBody.md) |
| 175 | + - [SchemaListResponse](docs/SchemaListResponse.md) |
| 176 | + - [SchemaPartialWriteRequestMetadata](docs/SchemaPartialWriteRequestMetadata.md) |
| 177 | + - [SchemaPartialWriteResponse](docs/SchemaPartialWriteResponse.md) |
| 178 | + - [SchemaReadBody](docs/SchemaReadBody.md) |
| 179 | + - [SchemaReadRequestMetadata](docs/SchemaReadRequestMetadata.md) |
| 180 | + - [SchemaReadResponse](docs/SchemaReadResponse.md) |
| 181 | + - [SchemaWriteBody](docs/SchemaWriteBody.md) |
| 182 | + - [SchemaWriteResponse](docs/SchemaWriteResponse.md) |
| 183 | + - [Select](docs/Select.md) |
| 184 | + - [SourceInfo](docs/SourceInfo.md) |
| 185 | + - [Status](docs/Status.md) |
| 186 | + - [StreamResultOfPermissionLookupEntityStreamResponse](docs/StreamResultOfPermissionLookupEntityStreamResponse.md) |
| 187 | + - [StreamResultOfWatchResponse](docs/StreamResultOfWatchResponse.md) |
| 188 | + - [Subject](docs/Subject.md) |
| 189 | + - [SubjectFilter](docs/SubjectFilter.md) |
| 190 | + - [SubjectPermissionBody](docs/SubjectPermissionBody.md) |
| 191 | + - [Subjects](docs/Subjects.md) |
| 192 | + - [Tenant](docs/Tenant.md) |
| 193 | + - [TenantCreateRequest](docs/TenantCreateRequest.md) |
| 194 | + - [TenantCreateResponse](docs/TenantCreateResponse.md) |
| 195 | + - [TenantDeleteResponse](docs/TenantDeleteResponse.md) |
| 196 | + - [TenantListRequest](docs/TenantListRequest.md) |
| 197 | + - [TenantListResponse](docs/TenantListResponse.md) |
| 198 | + - [Tuple](docs/Tuple.md) |
| 199 | + - [TupleFilter](docs/TupleFilter.md) |
| 200 | + - [TupleSet](docs/TupleSet.md) |
| 201 | + - [TupleToUserSet](docs/TupleToUserSet.md) |
| 202 | + - [V1Call](docs/V1Call.md) |
| 203 | + - [V1Expand](docs/V1Expand.md) |
| 204 | + - [V1Operation](docs/V1Operation.md) |
| 205 | + - [V1alpha1Reference](docs/V1alpha1Reference.md) |
| 206 | + - [V1alpha1Type](docs/V1alpha1Type.md) |
| 207 | + - [Values](docs/Values.md) |
| 208 | + - [WatchBody](docs/WatchBody.md) |
| 209 | + - [WatchResponse](docs/WatchResponse.md) |
| 210 | + - [WellKnownType](docs/WellKnownType.md) |
| 211 | + - [WriteRelationshipsBody](docs/WriteRelationshipsBody.md) |
| 212 | + |
| 213 | + |
| 214 | +<a id="documentation-for-authorization"></a> |
| 215 | +## Documentation For Authorization |
| 216 | + |
| 217 | + |
| 218 | +Authentication schemes defined for the API: |
| 219 | +<a id="ApiKeyAuth"></a> |
| 220 | +### ApiKeyAuth |
| 221 | + |
| 222 | +- **Type**: API key |
| 223 | +- **API key parameter name**: Authorization |
| 224 | +- **Location**: HTTP header |
| 225 | + |
| 226 | + |
| 227 | +## Author |
| 228 | + |
| 229 | +hello@permify.co |
| 230 | + |
| 231 | + |
0 commit comments