La principal funcionalidad que quería de Django REST Framework era la documentación automática de la API.

Luego descubrí que había un estándar para documentar APIs, usando JSON (o YAML, una extensión de JSON) llamado Swagger.

A principal funcionalidade que eu queria do Django REST Framework era a documentação automática da API.

Então descobri que existia um padrão para documentar APIs, utilizando JSON (ou YAML, uma extensão do JSON) chamado Swagger.

    }

    /**
     * Deletes document words (words with DOC_FREQ >= 1 that don't have QUERY or USER kinds).
     *
     * @param index The index name
     * @return The SuggestDeleteResponse
     */
    public SuggestDeleteResponse deleteDocumentWords(final String index) {
        if (logger.isInfoEnabled()) {
            logger.info("Deleting document words: index={}", index);
        }

Ici, nous passons `examples` contenant un exemple des données attendues dans `Body()` :

{* ../../docs_src/schema_extra_example/tutorial003_an_py310.py hl[22:29] *}

### Exemple dans l'interface des documents { #example-in-the-docs-ui }

Avec l'une des méthodes ci-dessus, cela ressemblerait à ceci dans le `/docs` :

<img src="/img/tutorial/body-fields/image01.png">

errors.target_file_does_not_exist = O arquivo {0} não existe.
errors.failed_to_delete_file = Não foi possível excluir o arquivo {0}.
errors.docid_not_found = ID do documento não encontrada. Causa: {0}
errors.document_not_found = URL do ID do documento não encontrada. Causa: {0}
errors.not_load_from_server = Não foi possível carregar deste servidor. Causa: {0}
errors.failed_to_start_job = Não foi possível iniciar o trabalho {0}.

    /**
     * Share flag indicating manual caching of documents.
     */
    public static final int SMB2_SHAREFLAG_MANUAL_CACHING = 0x0;
    /**
     * Share flag indicating automatic caching of documents.
     */
    public static final int SMB2_SHAREFLAG_AUTO_CACHING = 0x10;
    /**
     * Share flag indicating automatic caching of programs and documents.
     */
    public static final int SMB2_SHAREFLAG_VDO_CACHING = 0x20;

La principale fonctionnalité que j'ai emprunté à Django REST Framework était la documentation automatique des API.

Puis j'ai découvert qu'il existait une norme pour documenter les API, en utilisant JSON (ou YAML, une extension de JSON) appelée Swagger.

Il existait déjà une interface utilisateur Web pour les API Swagger. Donc, être capable de générer une documentation

additional input. // // WARNING: this type provides tightly scoped support for the DRBG // functionality we need for FIPS 140-3 _only_. This type _should not_ be used // outside of the FIPS 140-3 module for any other use. // // In particular, as documented, Counter does not support the derivation // function, or personalization strings which are necessary for safely using // this DRBG for generic purposes without leaking sensitive values. type Counter struct { // c is instantiated with K as the key...

    assert "Error processing docs/lang/docs/doc.md" in result.output
    assert (
        "Number of code blocks does not match the number "
        "in the original document (6 vs 5)"
    ) in result.output


@pytest.mark.parametrize(
    "copy_test_files",
    [(f"{data_path}/en_doc.md", f"{data_path}/translated_doc_number_lt.md")],
    indirect=True,
)

This will skip the normal events such as DNS, connecting to the network, and downloading the response body.

As recommended by the HTTP RFC the max age of a document is defaulted to 10% of the
document's age at the time it was served based on "Last-Modified". Default expiration dates aren't used for URIs
containing a query.

 - CallStart
 - **CacheHit**
 - CallEnd

### Cache Miss