Dart

Send XML REST Request, Get Response with No Body (Google Cloud Storage)

See more REST Examples

Demonstrates sending a RESTful XML request, and receiving a response where the expected response is a header with no body (Content-Length = 0). This example will create a bucket in Google Cloud Storage using the Google Cloud Storage XML API.

See Create a Bucket using the XML API for additional request options.

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // This example will create a bucket in Google Cloud Storage using the XML API.

  // It requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  final gAuth = CkAuthGoogle();
  // Obtain an access token as shown in one of the following examples:
  // See Get Access Token using a Service Account JSON Key
  // See Get Access Token using a P12 File

  final rest = CkRest();

  // Connect using TLS.
  final bAutoReconnect = true;
  rest.connect('www.googleapis.com', 443, true, bAutoReconnect);

  // Provide the authentication credentials (i.e. the access key)
  rest.setAuthGoogle(gAuth);

  // Build the XML request body for creating a bucket.
  // See https://cloud.google.com/storage/docs/xml-api/put-bucket-create
  final xmlReqBody = CkXml();
  xmlReqBody.tag = 'CreateBucketConfiguration';
  xmlReqBody.newChild2('LocationConstraint', 'us');
  xmlReqBody.newChild2('StorageClass', 'STANDARD');

  // Show the HTTP request body we'll be sending.
  print(xmlReqBody.getXml());

  // There are no query parameters...

  // The HOST header must be specified, because it needs to be different than
  // the domain previously passed to the Connect method.
  // The name of the bucket is the 1st part of the HOST header.
  rest.addHeader('Host', 'chilkat-example-bucket.storage.googleapis.com');

  // The project ID is specified in an HTTP request header
  rest.addHeader('x-goog-project-id', 'chilkattest-1050');

  // In this case, the response body is expected to be empty.  We can still
  // call FullRequestString.  We expect an empty string to be returned.
  final String responseStr;
  try {
    responseStr = rest.fullRequestString('PUT', '/', xmlReqBody.getXml());
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Check the response status code to make sure it is 200.
  final responseStatus = rest.responseStatusCode;
  print('Response Status Code = $responseStatus');
}