Java

DocuSign List Folders

See more DocuSign Examples

Retrieves a list of the folders for the account, including the folder hierarchy. You can specify type kinds of folders to return with the include query parameter. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Http;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.StringBuilder;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example assumes the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        Http http = new Http();

        // Implements the following HTTP request:
        // GET /restapi/v2.1/accounts/{accountId}/folders

        // Adds the "Authorization: Bearer eyJ0eXAi.....UE8Kl_V8KroQ" header.
        JsonObject jsonToken = new JsonObject();
        // Load a previously obtained OAuth2 access token.
        try {
            jsonToken.loadFile("qa_data/tokens/docusign.json");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        http.setAuthToken(jsonToken.stringOf("access_token"));

        // Use your account ID here:
        http.setUrlVar("accountId", "7f3f65ed-5e87-418d-94c1-92499ddc8252");

        StringBuilder sbResponseBody = new StringBuilder();
        try {
            http.quickGetSb("https://demo.docusign.net/restapi/v2.1/accounts/{$accountId}/folders", sbResponseBody);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        JsonObject jResp = new JsonObject();
        jResp.loadSb(sbResponseBody);
        jResp.setEmitCompact(false);

        System.out.println("Response Body:");
        System.out.println(jResp.emit());

        int respStatusCode = http.getLastStatus();
        System.out.println("Response Status Code = " + respStatusCode);
        if (respStatusCode >= 400) {
            System.out.println("Response Header:");
            System.out.println(http.getLastHeader());
            System.out.println("Failed.");
            return;
        }

        // Sample JSON response:
        // (Sample code for parsing the JSON response is shown below)

        // {
        //   "resultSetSize": "4",
        //   "startPosition": "0",
        //   "endPosition": "3",
        //   "totalSetSize": "4",
        //   "folders": [
        //     {
        //       "name": "Draft",
        //       "type": "draft",
        //       "owner": {
        //         "userName": "Joe Sample",
        //         "userId": "14602117-2430-4582-8a49-ba8766302272",
        //         "email": "admin@chilkatsoft.com"
        //       },
        //       "folderId": "f0bc5174-610d-4d80-80d7-91037843ccdb",
        //       "uri": "/folders/f0bc5174-610d-4d80-80d7-91037843ccdb",
        //       "itemCount": "0",
        //       "subFolderCount": "0",
        //       "hasSubFolders": "false"
        //     },
        //     {
        //       "name": "Inbox",
        //       "type": "inbox",
        //       "owner": {
        //         "userName": "Joe Sample",
        //         "userId": "14602117-2430-4582-8a49-ba8766302272",
        //         "email": "admin@chilkatsoft.com"
        //       },
        //       "folderId": "06c97346-f7b4-46fd-a204-038287d655ec",
        //       "uri": "/folders/06c97346-f7b4-46fd-a204-038287d655ec",
        //       "itemCount": "1",
        //       "subFolderCount": "0",
        //       "hasSubFolders": "false"
        //     },
        //     {
        //       "name": "Deleted Items",
        //       "type": "recyclebin",
        //       "owner": {
        //         "userName": "Joe Sample",
        //         "userId": "14602117-2430-4582-8a49-ba8766302272",
        //         "email": "admin@chilkatsoft.com"
        //       },
        //       "folderId": "6df0919e-b152-49fc-a4c9-9b430a29d4f5",
        //       "uri": "/folders/6df0919e-b152-49fc-a4c9-9b430a29d4f5",
        //       "itemCount": "0",
        //       "subFolderCount": "0",
        //       "hasSubFolders": "false"
        //     },
        //     {
        //       "name": "Sent Items",
        //       "type": "sentitems",
        //       "owner": {
        //         "userName": "Joe Sample",
        //         "userId": "14602117-2430-4582-8a49-ba8766302272",
        //         "email": "admin@chilkatsoft.com"
        //       },
        //       "folderId": "456f3c76-b265-4453-a024-c39b1a5cb387",
        //       "uri": "/folders/456f3c76-b265-4453-a024-c39b1a5cb387",
        //       "itemCount": "1",
        //       "subFolderCount": "0",
        //       "hasSubFolders": "false"
        //     }
        //   ]
        // }

        // Sample code for parsing the JSON response...
        // Use the following online tool to generate parsing code from sample JSON:
        // Generate Parsing Code from JSON

        String name = "";
        String v_type = "";
        String ownerUserName = "";
        String ownerUserId = "";
        String ownerEmail = "";
        String folderId = "";
        String uri = "";
        String itemCount = "";
        String subFolderCount = "";
        String hasSubFolders = "";

        String resultSetSize = jResp.stringOf("resultSetSize");
        String startPosition = jResp.stringOf("startPosition");
        String endPosition = jResp.stringOf("endPosition");
        String totalSetSize = jResp.stringOf("totalSetSize");
        int i = 0;
        int count_i = jResp.sizeOfArray("folders");
        while (i < count_i) {
            jResp.setI(i);
            name = jResp.stringOf("folders[i].name");
            v_type = jResp.stringOf("folders[i].type");
            ownerUserName = jResp.stringOf("folders[i].owner.userName");
            ownerUserId = jResp.stringOf("folders[i].owner.userId");
            ownerEmail = jResp.stringOf("folders[i].owner.email");
            folderId = jResp.stringOf("folders[i].folderId");
            uri = jResp.stringOf("folders[i].uri");
            itemCount = jResp.stringOf("folders[i].itemCount");
            subFolderCount = jResp.stringOf("folders[i].subFolderCount");
            hasSubFolders = jResp.stringOf("folders[i].hasSubFolders");
            i = i + 1;
        }
    }
}