Get font properties of a `Run` object Returns font properties of a Run object in a Word document.
Get font properties of a Run object in a Word document REST API   
Server 
Method 
Endpoint 
 
 
https://api.aspose.cloud/v4.0 
PUT 
/words/online/get/{paragraphPath}/runs/{index}/font 
 
 
, where:
paragraphPath  (required) — the path to the paragraph in the document tree. 
index  (required) — object index. 
 
You can use the following parameters in a REST request:
Parameter Name 
Data Type 
Required/Optional 
Description 
 
 
loadEncoding 
string 
Optional 
Encoding that will be used to load an HTML (or TXT) document if the encoding is not specified in HTML. 
 
password 
string 
Optional 
Password of protected Word document. Use the parameter to pass a password via SDK. SDK encrypts it automatically. We don’t recommend to use the parameter to pass a plain password for direct call of API. 
 
encryptedPassword 
string 
Optional 
Password of protected Word document. Use the parameter to pass an encrypted password for direct calls of API. See SDK code for encyption details. 
 
 
Use $multipart/form-data request to combine one or more properties into a single body:
Property Name 
Data Type 
Required/Optional 
Description 
 
 
document 
string(binary) 
Required 
The document. 
 
 
Note : to access this REST API, you need to register and get personal credentials. Use the ‘
Quick Start ’ guide to go through the procedure in a couple of minutes.
 
Get font properties of a Run object in a Word document usage examples   
Let’s look at practical examples of using the web service. You can do this both with cURL and Postman utilities, and from your code in various programming languages: Python, Java, JavaScript, C#, PHP, C++, Go, Ruby, Swift, Dart.
How to get font properties of a Run object in a Word document with cURL or Postman   
One of the easiest and fastest ways to call a REST API is to use cURL or Postman:
    
  
       
      cURL Request 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          curl -v "https://api.aspose.cloud/v4.0/words/online/get/paragraphs/0/runs/0/font" \
 
         
        
           
               -X PUT \
 
         
        
           
               -H "Content-Type: multipart/form-data" \
 
         
        
           
               -H "Authorization: Bearer ####################" \
 
         
        
           
               -F Document="@Sample.docx" 
         
  
 
     
   
 
       
      
     
 
To get a JWT token use these instructions 
 
       
      Postman Request 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          {
 
         
        
           
              "info": {
 
         
        
           
                  "name": "GetRunFontOnline",
 
         
        
           
                  "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 
         
        
           
              },
 
         
        
           
              "auth": {
 
         
        
           
                  "type": "oauth2",
 
         
        
           
                  "oauth2": [
 
         
        
           
                      {
 
         
        
           
                          "key": "clientSecret",
 
         
        
           
                          "value": "{{CLIENT_SECRET}}",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "clientId",
 
         
        
           
                          "value": "{{CLIENT_ID}}",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "addTokenTo",
 
         
        
           
                          "value": "header",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "client_authentication",
 
         
        
           
                          "value": "body",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "accessTokenUrl",
 
         
        
           
                          "value": "https://api.aspose.cloud/connect/token",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "grant_type",
 
         
        
           
                          "value": "client_credentials",
 
         
        
           
                          "type": "string"
 
         
        
           
                      },
 
         
        
           
                      {
 
         
        
           
                          "key": "tokenName",
 
         
        
           
                          "value": "Access Token",
 
         
        
           
                          "type": "string"
 
         
        
           
                      }
 
         
        
           
                  ]
 
         
        
           
              },
 
         
        
           
              "item": [
 
         
        
           
                  {
 
         
        
           
                      "name": "request",
 
         
        
           
                      "protocolProfileBehavior": {
 
         
        
           
                          "disableBodyPruning": true
 
         
        
           
                      },
 
         
        
           
                      "request": {
 
         
        
           
                          "method": "PUT",
 
         
        
           
                          "header": [
 
         
        
           
                          ],
 
         
        
           
                          "body": {
 
         
        
           
                              "mode": "formdata",
 
         
        
           
                              "formdata": [
 
         
        
           
                                  {
 
         
        
           
                                      "key": "Document",
 
         
        
           
                                      "type": "file",
 
         
        
           
                                      "src": "Sample.docx"
 
         
        
           
                                  }
 
         
        
           
                              ]
 
         
        
           
                          },
 
         
        
           
                          "url": {
 
         
        
           
                              "raw": "https://api.aspose.cloud/v4.0/words/online/get/paragraphs/0/runs/0/font",
 
         
        
           
                              "protocol": "https",
 
         
        
           
                              "host": [
 
         
        
           
                                  "api",
 
         
        
           
                                  "aspose",
 
         
        
           
                                  "cloud"
 
         
        
           
                              ],
 
         
        
           
                              "path": [
 
         
        
           
                                  "v4.0",
 
         
        
           
                                  "words",
 
         
        
           
                                  "online",
 
         
        
           
                                  "get",
 
         
        
           
                                  "paragraphs",
 
         
        
           
                                  "0",
 
         
        
           
                                  "runs",
 
         
        
           
                                  "0",
 
         
        
           
                                  "font"
 
         
        
           
                              ],
 
         
        
           
                              "query": [
 
         
        
           
                              ]
 
         
        
           
                          }
 
         
        
           
                      },
 
         
        
           
                      "response": []
 
         
        
           
                  }
 
         
        
           
              ],
 
         
        
           
              "variable": [
 
         
        
           
              ]
 
         
        
           
          } 
         
  
 
     
   
 
       
      
     
 
To get a JWT token use these instructions 
 
 
 
How to get font properties of a Run object in a Word document in Python, Java, C#, C++, JavaScript and other programming languages   
Using SDK is the quickest way to speed up the development. Please take a look at the provided code examples to quickly call this web service from your favourite programming language:
    
  
       
      Python 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import os
 
         
        
           
          import asposewordscloud
 
         
        
           
          import asposewordscloud.models.requests
 
         
        
           
          from asposewordscloud.rest import ApiException
 
         
        
           
          from shutil import copyfile
 
         
        
           
          
 
         
        
           
          words_api = WordsApi(client_id = '####-####-####-####-####', client_secret = '##################') 
 
         
        
           
          request_document = open('Sample.docx', 'rb')
 
         
        
           
          request = asposewordscloud.models.requests.GetRunFontOnlineRequest(document=request_document, paragraph_path='paragraphs/0', index=0)
 
         
        
           
          words_api.get_run_font_online(request)
 
         
  
 
     
   
 
       
      
     
 
 
       
      Java 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import com.aspose.words.cloud.*;
 
         
        
           
          import com.aspose.words.cloud.api.*;
 
         
        
           
          import com.aspose.words.cloud.model.*;
 
         
        
           
          import com.aspose.words.cloud.model.requests.*;
 
         
        
           
          import com.aspose.words.cloud.model.responses.*;
 
         
        
           
          import java.nio.file.Files;
 
         
        
           
          import java.nio.file.Paths;
 
         
        
           
          
 
         
        
           
          ApiClient apiClient = new ApiClient(/*clientId*/ "####-####-####-####-####", /*clientSecret*/ "##################", null);
 
         
        
           
          WordsApi wordsApi = new WordsApi(apiClient);
 
         
        
           
          byte[] requestDocument = Files.readAllBytes(Paths.get("Sample.docx").toAbsolutePath());
 
         
        
           
          GetRunFontOnlineRequest request = new GetRunFontOnlineRequest(requestDocument, "paragraphs/0", 0, null, null, null);
 
         
        
           
          wordsApi.getRunFontOnline(request);
 
         
  
 
     
   
 
       
      
     
 
 
       
      Node.js 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import * as fs from "fs";
 
         
        
           
          
 
         
        
           
          const clientId = "####-####-####-####-####";
 
         
        
           
          const secret = "##################";
 
         
        
           
          const wordsApi = new WordsApi(clientId, secret);
 
         
        
           
          const requestDocument = fs.createReadStream("Sample.docx");
 
         
        
           
          const request = new model.GetRunFontOnlineRequest({
 
         
        
           
              document: requestDocument,
 
         
        
           
              paragraphPath: "paragraphs/0",
 
         
        
           
              index: 0
 
         
        
           
          });
 
         
        
           
          
 
         
        
           
          wordsApi.getRunFontOnline(request)
 
         
        
           
          .then((requestResult) => {
 
         
        
           
              // tslint:disable-next-line:no-console
 
         
        
           
              console.log("Result of request: ", requestResult);
 
         
        
           
          });
 
         
  
 
     
   
 
       
      
     
 
 
       
      C# 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          using System;
 
         
        
           
          using System.Collections.Generic;
 
         
        
           
          using System.IO;
 
         
        
           
          using System.Linq;
 
         
        
           
          using System.Threading.Tasks;
 
         
        
           
          using Aspose.Words.Cloud.Sdk;
 
         
        
           
          using Aspose.Words.Cloud.Sdk.Model;
 
         
        
           
          using Aspose.Words.Cloud.Sdk.Model.Requests;
 
         
        
           
          
 
         
        
           
          var config = new Configuration { ClientId = "####-####-####-####-####", ClientSecret = "##################" };
 
         
        
           
          var wordsApi = new WordsApi(config);
 
         
        
           
          using var requestDocument = File.OpenRead("Sample.docx");
 
         
        
           
          var request = new GetRunFontOnlineRequest(requestDocument, "paragraphs/0", 0);
 
         
        
           
          await wordsApi.GetRunFontOnline(request);
 
         
  
 
     
   
 
       
      
     
 
 
       
      PHP 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          <?php
 
         
        
           
          use Aspose\Words\WordsApi;
 
         
        
           
          use Aspose\Words\Model\Requests\{GetRunFontOnlineRequest};
 
         
        
           
          
 
         
        
           
          $clientId = '####-####-####-####-####';
 
         
        
           
          $secret = '##################';
 
         
        
           
          $wordsApi = new WordsApi($clientId, $secret);
 
         
        
           
          $requestDocument = "Sample.docx";
 
         
        
           
          $request = new GetRunFontOnlineRequest(
 
         
        
           
              $requestDocument, "paragraphs/0", 0, NULL, NULL, NULL);
 
         
        
           
          $wordsApi->getRunFontOnline($request);
 
         
  
 
     
   
 
       
      
     
 
 
       
      C++ 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          #include "aspose_words_cloud.h"
 
         
        
           
          using namespace aspose::words::cloud;
 
         
        
           
          
 
         
        
           
          auto config = std::make_shared<ApiConfiguration>(/*clientId*/ L"####-####-####-####-####", /*clientSecret*/ L"##################");
 
         
        
           
          auto wordsApi = std::make_shared<WordsApi>(config);
 
         
        
           
          auto requestDocument = std::shared_ptr<std::istream>(new std::ifstream(std::filesystem::path(L"Sample.docx"), std::istream::binary));
 
         
        
           
          std::shared_ptr<requests::GetRunFontOnlineRequest> request(
 
         
        
           
              new requests::GetRunFontOnlineRequest(
 
         
        
           
                  requestDocument, std::make_shared<std::wstring>(L"paragraphs/0"), std::make_shared<int32_t>(0)));
 
         
        
           
          wordsApi->getRunFontOnline(request);
 
         
  
 
     
   
 
       
      
     
 
 
       
      Go 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          { 
         
        
           
            "ClientId" : " ####-####-####-####-####"  , 
         
        
           
            "ClientSecret" : " ##################"  , 
         
        
           
            "BaseUrl" : " https://api.aspose.cloud"  
         
        
           
          } 
         
  
 
     
   
 
       
      
     
 
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import (
 
         
        
           
              "os"
 
         
        
           
              "github.com/aspose-words-cloud/aspose-words-cloud-go/dev/api/models")
 
         
        
           
          
 
         
        
           
          config, _ := models.NewConfiguration("config.json")
 
         
        
           
          wordsApi, ctx, _ := api.CreateWordsApi(config)
 
         
        
           
          requestDocument, _ := os.Open("Sample.docx")
 
         
        
           
          requestOptions := map[string]interface{}{}
 
         
        
           
          request := &models.GetRunFontOnlineRequest{
 
         
        
           
              Document: requestDocument,
 
         
        
           
              ParagraphPath: ToStringPointer("paragraphs/0"),
 
         
        
           
              Index: ToInt32Pointer(int32(0)),
 
         
        
           
              Optionals: requestOptions,
 
         
        
           
          }
 
         
        
           
          _, _, _ = wordsApi.GetRunFontOnline(ctx, request)
 
         
  
 
     
   
 
       
      
     
 
 
       
      Ruby 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          require 'aspose_words_cloud'
 
         
        
           
          
 
         
        
           
          AsposeWordsCloud.configure do |config|
 
         
        
           
            config.client_data['ClientId'] = '####-####-####-####-####'
 
         
        
           
            config.client_data['ClientSecret'] = '##################'
 
         
        
           
          end
 
         
        
           
          @words_api = WordsAPI.new
 
         
        
           
          request_document = File.open('Sample.docx')
 
         
        
           
          request = GetRunFontOnlineRequest.new(document: request_document, paragraph_path: 'paragraphs/0', index: 0)
 
         
        
           
          @words_api.get_run_font_online(request)
 
         
  
 
     
   
 
       
      
     
 
 
       
      Swift 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import AsposeWordsCloud
 
         
        
           
          
 
         
        
           
          let config = Configuration(clientId: "####-####-####-####-####", clientSecret: "##################");
 
         
        
           
          let api = try WordsAPI(configuration: config);
 
         
        
           
          let requestDocument = InputStream(url: URL(string: "Sample.docx"))!;
 
         
        
           
          let request = GetRunFontOnlineRequest(document: requestDocument, paragraphPath: "paragraphs/0", index: 0);
 
         
        
           
          _ = try api.getRunFontOnline(request: request);
 
         
  
 
     
   
 
       
      
     
 
 
       
      Dart 
      
    
      
        
  
    
    
        
  
  
  
     
 
    
      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      Learn more about bidirectional Unicode characters 
     
  
  
  
    
     
 
  
  
        
           
          import  'dart:io' ; 
         
        
           
          import  'package:aspose_words_cloud/aspose_words_cloud.dart' ; 
         
        
           
          
 
         
        
           
          final  clientId =  "####-####-####-####-####" ; 
         
        
           
          final  clientSecret =  "##################" ; 
         
        
           
          final  config =  Configuration (clientId, clientSecret); 
         
        
           
          final  wordsApi =  WordsApi (config); 
         
        
           
          final  requestDocument =  (await  File ('Sample.docx' ).readAsBytes ()).buffer.asByteData (); 
         
        
           
          final  request =  GetRunFontOnlineRequest (requestDocument, 'paragraphs/0' , 0 ); 
         
        
           
          await  wordsApi.getRunFontOnline (request); 
         
  
 
     
   
 
       
      
     
 
 
 
 
See Also   
GitHub repository  — explore Aspose.Words Cloud SDK Family. These software libraries take care of all low-level document-processing details.