設定

OpenEmail client = OpenEmail.builder()    .apiKey(System.getenv("OPENEMAIL_API_KEY"))    .baseUrl("https://api.openemail.uk")    .timeout(Duration.ofSeconds(30))    .maxRetries(2)    .header("X-Team", "billing")    .build(); System.out.println(client.mode());

省略したものはすべて環境から読み取られます。OPENEMAIL_API_KEY、次に OPENEMAIL_ACCESS_TOKEN、そして OPENEMAIL_BASE_URL です。client.mode() は、キーが live キーか test キーかを示します。

クエリパラメーターと呼び出しの設定は、引数のあとに渡す RequestOptions に入れます。apiKey、idempotencyKey、timeout、limit、cursor にはそれぞれメソッドがあり、set はそれ以外のオプションを API が使う名前で受け取ります。各メソッドはリファレンスの項目に載っているオプションを受け付け、当てはまらないオプションは何も送信される前に拒否されます。

RequestOptions options = RequestOptions.of("folder", "inbox")    .apiKey(System.getenv("OPENEMAIL_API_KEY"))    .timeout(Duration.ofSeconds(5))    .limit(50); Page threads = client.threads().list(options); System.out.println(threads.size());

RequestOptions は不変です。どのメソッドも新しいインスタンスを返すため、共有している値が、そこに追加するコードによって変わることはありません。スレッドに割り込むと、待機中の呼び出しが止まります。

• —oe_live_ または oe_test_ で始まらないキー、およびアクセストークンと一緒に渡されたキー。
• —平文の http: での資格情報の送信。ただしサーバーがこのマシンの localhost、127.x.x.x のアドレス、または ::1 にある場合は除きます。
• —0.0.0.0 のベース URL。これはサーバーが待ち受けるアドレスです。同じポートで 127.0.0.1 を使ってください。
• —空の id、またはドットだけでできた id。URL パーサーが取り除いてしまいます。
• —リダイレクトをたどること。既定の HTTP クライアントはリダイレクトを決してたどらないため、資格情報が別のホストに渡ることはありません。

client.raw().request は、クライアントの資格情報、ベース URL、タイムアウト、再試行ポリシーを使って任意のパスを呼び出します。パスは 1 つの / で始まる必要があり、ベース URL のオリジンを離れるパスは拒否されます。

Object label = client.raw().request("POST", "/labels", Body.of("name", "Invoices")); System.out.println(label);