Skip to content

Latest commit

 

History

History
173 lines (119 loc) · 7.67 KB

README.md

File metadata and controls

173 lines (119 loc) · 7.67 KB
Raw

Clients

(clients())

Overview

The Client object tracks sessions, as well as the state of any sign in and sign up attempts, for a given device. https://clerk.com/docs/reference/clerkjs/client

Available Operations

  • list - List all clients ⚠️ Deprecated
  • verify - Verify a client
  • get - Get a client

list

Returns a list of all clients. The clients are returned sorted by creation date, with the newest clients appearing first. Warning: the endpoint is being deprecated and will be removed in future versions.

⚠️ DEPRECATED: This will be removed in a future release, please migrate away from it as soon as possible.

Example Usage

package hello.world;

import com.clerk.backend_api.Clerk;
import com.clerk.backend_api.models.errors.ClerkErrors;
import com.clerk.backend_api.models.operations.GetClientListResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ClerkErrors, Exception {

        Clerk sdk = Clerk.builder()
                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
            .build();

        GetClientListResponse res = sdk.clients().list()
                .limit(10L)
                .offset(0L)
                .call();

        if (res.clientList().isPresent()) {
            // handle response
        }
    }
}

Parameters

Parameter Type Required Description
limit Optional<Long> ➖ Applies a limit to the number of results returned.
Can be used for paginating the results together with offset.
offset Optional<Long> ➖ Skip the first offset results when paginating.
Needs to be an integer greater or equal to zero.
To be used in conjunction with limit.

Response

GetClientListResponse

Errors

Error Type Status Code Content Type
models/errors/ClerkErrors 400, 401, 410, 422 application/json
models/errors/SDKError 4XX, 5XX */*

verify

Verifies the client in the provided token

Example Usage

package hello.world;

import com.clerk.backend_api.Clerk;
import com.clerk.backend_api.models.errors.ClerkErrors;
import com.clerk.backend_api.models.operations.VerifyClientRequestBody;
import com.clerk.backend_api.models.operations.VerifyClientResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ClerkErrors, Exception {

        Clerk sdk = Clerk.builder()
                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
            .build();

        VerifyClientRequestBody req = VerifyClientRequestBody.builder()
                .build();

        VerifyClientResponse res = sdk.clients().verify()
                .request(req)
                .call();

        if (res.client().isPresent()) {
            // handle response
        }
    }
}

Parameters

Parameter Type Required Description
request VerifyClientRequestBody ✔️ The request object to use for the request.

Response

VerifyClientResponse

Errors

Error Type Status Code Content Type
models/errors/ClerkErrors 400, 401, 404 application/json
models/errors/SDKError 4XX, 5XX */*

get

Returns the details of a client.

Example Usage

package hello.world;

import com.clerk.backend_api.Clerk;
import com.clerk.backend_api.models.errors.ClerkErrors;
import com.clerk.backend_api.models.operations.GetClientResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws ClerkErrors, Exception {

        Clerk sdk = Clerk.builder()
                .bearerAuth("<YOUR_BEARER_TOKEN_HERE>")
            .build();

        GetClientResponse res = sdk.clients().get()
                .clientId("<id>")
                .call();

        if (res.client().isPresent()) {
            // handle response
        }
    }
}

Parameters

Parameter Type Required Description
clientId String ✔️ Client ID.

Response

GetClientResponse

Errors

Error Type Status Code Content Type
models/errors/ClerkErrors 400, 401, 404 application/json
models/errors/SDKError 4XX, 5XX */*