In diesem Fall möchten Sie möglicherweise dokumentieren, wie diese externe API aussehen *sollte*. Welche *Pfadoperation* sie haben sollte, welchen Body sie erwarten sollte, welche Response sie zurückgeben sollte, usw.

## Eine Anwendung mit Callbacks

Sehen wir uns das alles anhand eines Beispiels an.

Stellen Sie sich vor, Sie entwickeln eine Anwendung, mit der Sie Rechnungen erstellen können.

        .addNetworkInterceptor(chain -> {
          Response originalResponse = chain.proceed(chain.request());
          return originalResponse.newBuilder()
              .body(new ProgressResponseBody(originalResponse.body(), progressListener))
              .build();
        })
        .build();

    try (Response response = client.newCall(request).execute()) {

    val call = client.newCall(networkRequest)

    call.execute().use { response ->
      assertThat(response.code).isEqualTo(200)
      assertThat(response.cacheResponse).isNull()
    }

    val cachedCall = client.newCall(request)

    cachedCall.execute().use { response ->
      assertThat(response.code).isEqualTo(200)
      assertThat(response.cacheResponse).isNotNull()
    }
  }

  @Test

///

## OpenAPI и документация API

Если вы возвращаете дополнительные коды статусов и ответы напрямую, они не будут включены в схему OpenAPI (документацию API), потому что FastAPI не может заранее знать, что вы собираетесь вернуть.

        assertTrue(reqCap.getValue() instanceof NtTransNotifyChange, "SMB1 notify request must be used");
    }

    // If a response is not marked as received, throw a CIFSException
    @Test
    @DisplayName("watch() throws CIFSException when response not received")
    void watch_responseNotReceived_throwsCIFSException() throws Exception {
        NotifyResponse resp = mock(NotifyResponse.class);

});
```

#### 4. Asynchronous Suggestions

```java
suggester.suggest()
    .setQuery("sea")
    .execute()
    .done(response -> {
        // Handle successful response
        response.getItems().forEach(item -> 
            System.out.println("Async suggestion: " + item.getText()[0])
        );
    })
    .error(throwable -> {
        // Handle error

 * until [nextPart] returns null. After calling [nextPart] any preceding parts should not be read.
 *
 * Typical use loops over the parts in sequence:
 *
 * ```kotlin
 * val response: Response = call.execute()
 * val multipartReader = MultipartReader(response.body!!)
 *
 * multipartReader.use {
 *   while (true) {
 *     val part = multipartReader.nextPart() ?: break
 *     process(part.headers, part.body)
 *   }
 * }
 * ```

import org.codelibs.fess.helper.PermissionHelper;
import org.codelibs.fess.opensearch.config.exentity.WebConfig;
import org.codelibs.fess.util.ComponentUtil;
import org.lastaflute.web.Execute;
import org.lastaflute.web.response.JsonResponse;

import jakarta.annotation.Resource;

/**
 * API action for admin web configuration management.
 *
 */
public class ApiAdminWebconfigAction extends FessApiAdminAction {

import jcifs.internal.smb1.ServerMessageBlock;

/**
 * Response for SMB1 COM_SET_INFORMATION command.
 *
 * This response indicates the success or failure of setting file
 * attributes and last write time.
 *
 * @author mbechler
 */
public class SmbComSetInformationResponse extends ServerMessageBlock {

    /**
     * Constructs a set information response.
     *
     * @param config the configuration to use
     */

import jcifs.internal.util.SMBUtil;

/**
 * SMB2 Flush response message.
 *
 * This response confirms that buffered data has been
 * successfully flushed to the storage device.
 *
 * @author mbechler
 */
public class Smb2FlushResponse extends ServerMessageBlock2Response {

    /**
     * Constructs an SMB2 flush response
     * @param config the client configuration
     */