API REST Java Cloud para Anotação de Documentos

O GroupDocs.Annotation Cloud SDK para Java ajuda você a criar aplicativos Java para anotar documentos na nuvem que funcionam sem a necessidade de instalar qualquer software de terceiros. Ele é um wrapper em torno das APIs REST do GroupDocs.Annotation Cloud.

Requisitos

• Versão do Java: Para construir a biblioteca cliente da API, é necessário Java 1.7+.
• Ferramenta de Construção: Maven é necessário para gerenciar dependências e construir o projeto.

Pré-requisitos

• Conta GroupDocs Cloud: Para usar o GroupDocs.Annotation Cloud SDK para Java, você precisa registrar uma conta no GroupDocs Cloud.
• ID do Cliente e Segredo do Cliente: Após registrar-se, você precisará consultar ou criar seu ID do Cliente e Segredo do Cliente no Painel da Nuvem.
• Cota Gratuita: O GroupDocs Cloud oferece uma cota gratuita para novos usuários. Para mais detalhes, você deve verificar o Preços do GroupDocs Cloud.

Instalar o GroupDocs.Annotation-Cloud pelo Maven

Para instalar o GroupDocs.Annotation Cloud SDK para Java, você precisa adicionar o repositório GroupDocs Cloud ao arquivo pom.xml do seu aplicativo:

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

Instalar a partir do Código Fonte

Para instalar a biblioteca cliente da API a partir do código fonte, siga estas etapas:

• Instalar no Repositório Maven Local: Para instalar a biblioteca no seu repositório Maven local, basta executar o seguinte comando no terminal:

mvn clean install

• Implantar no Repositório Maven Remoto: Se você desejar implantar em um repositório Maven remoto, configure as configurações do repositório e execute o seguinte comando:

mvn clean deploy

Para mais detalhes sobre a implantação em um repositório remoto, consulte o Guia OSSRH.

Usuários do Maven

Se você é um usuário do Maven, pode adicionar o GroupDocs.Annotation Cloud SDK para Java como uma dependência no arquivo pom.xml do seu projeto:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation-cloud</artifactId>
    <version>22.2</version>
    <type>pom</type>
</dependency>

Primeiros Passos

Para começar a usar o GroupDocs.Annotation Cloud SDK para Java, siga estas etapas:

1. Instalar o SDK: Instale o SDK seguindo as etapas descritas acima (usando Maven ou instalando a partir do código fonte).
2. Configuração: Configure o SDK utilizando seu ID do Cliente e Segredo do Cliente obtidos no Painel do GroupDocs Cloud.
3. Código de Exemplo: Implemente o código de exemplo em sua aplicação para adicionar anotações, extrair informações de documentos ou gerenciar arquivos e pastas.
4. Documentação: Consulte as instruções de Início Rápido e a documentação da API para exemplos detalhados de uso e informações adicionais.

Autorização & Autenticação

O GroupDocs.Annotation Cloud SDK para Java usa OAuth 2.0 para autorização e autenticação. Os seguintes detalhes são fornecidos:

• Tipo de Autorização: OAuth 2.0
• Fluxo: Autorização baseada em aplicação
• URL de Autorização: https://api.groupdocs.cloud/connect/token
• Duração do Token: 1 dia (por padrão)

JWT

O GroupDocs.Annotation Cloud SDK utiliza JSON Web Tokens (JWT) para acesso seguro à API:

• Tipo de Token: OAuth 2.0 JWT (JSON Web Token)
• URL de Autorização: Os tokens são gerados usando o endpoint https://api.groupdocs.cloud/connect/token.
• Expiração do Token: A duração padrão do token é de 1 dia, garantindo acesso seguro e temporário à API.

Esses detalhes fornecem um guia abrangente para configurar e usar o GroupDocs.Annotation Cloud SDK para Java, cobrindo os requisitos essenciais, etapas de instalação e configurações de segurança.

Aqui estão dois dos trechos de código mais vendáveis extraídos do conteúdo fornecido. Esses trechos mostram funcionalidades essenciais que atrairiam usuários potenciais interessados em integrar capacidades de anotação em suas aplicações.

Código de Exemplo em Java para Adicionar uma Anotação de Ponto

Este trecho demonstra como adicionar uma anotação de ponto a um documento usando o GroupDocs.Annotation Cloud SDK para Java. As anotações de ponto são úteis para marcar pontos específicos em um documento com comentários ou notas.

// Para exemplos completos e arquivos de dados, acesse https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud
String MyAppSid

 = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Criar anotação(s).
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Point pt = new Point();
pt.setX(1.0);
pt.setY(1.0);
annotations[0].setAnnotationPosition(pt);

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(200.0);
r.setHeight(100.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.POINT);
annotations[0].setText("Esta é uma anotação de ponto");
annotations[0].setCreatorName("Anonym A.");

// Criar objeto de solicitação.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\one-page.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/one-page-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Executar método da API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Anotação de Ponto adicionada: " + result.getTitle());

Código de Exemplo em Java para Adicionar uma Anotação de Destaque de Texto

Este trecho de código mostra como adicionar uma anotação de destaque de texto a um documento. Destacar texto é uma tarefa comum de anotação, especialmente em processos de revisão, e este trecho ilustra como isso pode ser feito programaticamente.

// Para exemplos completos e arquivos de dados, acesse https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Criar anotação(s).
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(300.0);
r.setHeight(50.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.TEXT_HIGHLIGHT);
annotations[0].setText("Este texto está destacado");
annotations[0].setCreatorName("Anonym A.");

// Criar objeto de solicitação.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\sample.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/sample-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Executar método da API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Anotação de Destaque de Texto adicionada: " + result.getTitle());