(.NET Core C#) Interfax -- Fax a Single Document

Demonstrates how to use the REST API to fax a single document using interfax.net. See Send fax for more information.

This example will send a POST with these potential query params:

POST /outbound/faxes?faxNumber={faxnumber}[&contact={string}&postponeTime={datetime}
&retriesToPerform={number}&csid={string}&pageHeader={string}&reference={string}
&replyAddress={email}&pageSize={a4|letter|legal|b4}&fitToPage={scale|noscale}
&pageOrientation={portrait|landscape}&resolution={fine|standard}&rendering={greyscale|bw}]

POST /outbound/faxes?faxNumber={faxnumber}&... HTTP/1.1
Host: rest.interfax.net
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/msword
 
{binary content goes here}

Chilkat .NET Downloads Chilkat .NET Assemblies Chilkat for .NET Core Chilkat for Mono

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

Chilkat.Rest rest = new Chilkat.Rest();

// Use Basic Authentication.
// Use your InterFAX login and password.
bool success = rest.SetAuthBasic("INTERFAX_LOGIN","INTERFAX_PASSWORD");

// Connect to the Interfax REST server.
// Make sure TLS is used.  One should NEVER send a username+password using Basic authentication
// over a non-secure connection.
bool bTls = true;
int port = 443;
bool bAutoReconnect = true;
success = rest.Connect("rest.interfax.net",port,bTls,bAutoReconnect);

// Indicate the Content-Type of our upload.  
// We're faxing a PDF, so set the content-type to application/pdf.
success = rest.AddHeader("Content-Type","application/pdf");

// We can add an "Expect: 100-continue" header so that if the request is rejected
// by the server immediately after receiving the request header, it can respond
// and the client (Chilkat) can avoid sending the file data.
// (this is optional)
success = rest.AddHeader("Expect","100-continue");

Chilkat.Stream fileStream = new Chilkat.Stream();

// The stream's source will be a file.
fileStream.SourceFile = "qa_data/pdf/fishing.pdf";

// Add query params.
// The fax number format is "+1-212-3456789"
rest.AddQueryParam("faxNumber","MY-FAX-NUMBER");
rest.AddQueryParam("pageSize","letter");
// Add any other desired query params ...

// The response is a 0-length "201 Created" response.
// Therefore the responseStr will be empty.
string responseStr = rest.FullRequestStream("POST","/outbound/faxes",fileStream);
if (rest.LastMethodSuccess != true) {
    Debug.WriteLine(rest.LastErrorText);
    return;
}

if (rest.ResponseStatusCode != 201) {
    // The response was not successful.
    // We can examine the response code, header and status text:
    Debug.WriteLine("Response status code: " + Convert.ToString(rest.ResponseStatusCode));
    Debug.WriteLine("Response status text: " + rest.ResponseStatusText);
    Debug.WriteLine("Response header: " + rest.ResponseHeader);
    Debug.WriteLine("FAX failed.");
}
else {
    Debug.WriteLine("FAX sent.");
}