Skip to content

Commit 8adf344

Browse files
authored
Update README.md
1 parent 7f3cdb2 commit 8adf344

1 file changed

Lines changed: 230 additions & 1 deletion

File tree

README.md

Lines changed: 230 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,231 @@
11
# 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

Comments
 (0)