API - Simple Fax Usuage

I’ve taken a look at the API links you’ve provided.
I just had a couple questions for you:

1. Did
you have any simple .net example solutions which demonstrate a how to
send a fax, as opposed to the simple Authenticate example.

2. Looking
at the API, it seems that payload (images etc) we wish to fax, we need to host
on our end. I was wondering if the API also allowed transmission of the
serialised data in the request, as opposed to a url to the resource that we
have to host.

3. The
“Basic” pdf guide shows for sending faxes describes having to make a call to
set up a destination list , and then a call to a submit job using the prior
list.

Does the API for JobSubmit request allow you to
specific a single Fax number. I.e. can we send a fax to a faxnumber in a
single call, without having to create a list before, requiring 2 faxes.

Find more posts tagged with

Comments

thuneke

1) Yes, you can search for C# or VB samples. Here is the URL for a fax submit. https://apiforums.easylink.com/content/c-sample-jobsubmit-fax-options

This is the URL for the helper functions referenced in the sample. https://apiforums.easylink.com/content/c-sample-helper-functions

2) You can pass the images/docs in the job submit, reference them at your URL, or store in our Customer Document Store and reference them there.

3) Yes you can send to a single destination. The sample above shows this as well as passing a CSV file. With the list and CSV file you can personalize your coversheet, specific fields, and the body using insert fields. This can also be done for single destination in the JobSubmit.

The above sample is for API 2.5, the latest. You will need to import the JobSubmit and the AuthenticateRequest WSDL's into your .NET Project.

We recommend you use the sych URL. This returns the Request Result in the same connection and makes it easier to match your Request and Result.

If you will be using the API for reporting on the jobs you should store the XDN(domain name) and MRN(job number) returned in the result.

Migrateduser

I am new here, may I ask how to import the JobSubmit and the AuthenticateRequest WSDL's into your .NET Project?

Thanks,

Evelyn

Migrateduser

For example, I tried to add web reference in my project by using http://ws.easylink.com/JobSubmit/2011/01?WSDL, I can see the JobSubmit method, but I can't add reference ( it is still disabled). The message is

Operation is not valid due to the current state of the object.

Evelyn

thuneke

What are you using, C# or VB?

Migrateduser

I use C# -- Evelyn

thuneke

In your project open the Solutions Explorer view, right click Web References and select Add a Refereence. In the URL field paste in the WSDL from the Overview in the API doc for JobSubmit and click Go. It will give it the default name of com.easylink.ws. I rename it to JobSubmit to make it easier. If you want to use the sample as is rename it EMsgAPI_JobSubmit201101. Otherwise rename EMsgAPI_JobSubmit201101 in the code to JobSubmit.

You will also need to adjust the first line under

// setup EMsgAPI object - EM

to fit your applicaation.

Migrateduser

Thank you for your comment.

This is what I did, I think it is exactly what you mentioned.

1) right click Web References and select Add web Refereence, the add web reference screen come up

2) I put the URL in the URL text box: http://ws.easylink.com/JobSubmit/2011/01?WSDL

3)Click Go button.

This is what I got:

I can see the method definition on my left side panel, on right hand side panel, under "Web Services found at this URL", there is message as :

Operation is not valid due to the current state of the object.

And the Add reference button is disabled.

Evelyn

thuneke

It sounds like you are not getting out to the URL. I just created a new project, did the same and get 1 Service Found in my right window. Try clicking on the URL in the API doc. It should display the WSDL.

thuneke

Actually that does not make sense because the name is showing in the left box. Do a search in Google for:

Operation is not valid due to the current state of the object. web reference

I did find this about proxy serrver.

http://forums.asp.net/t/1331361.aspx/1

Migrateduser

In . https://apiforums.easylink.com/content/c-sample-jobsubmit-fax-options, There are two functions are not included ReadAndEncodedFile and Set_Server_and_Proxy, can the support team provide the code?

Thanks,

Evelyn

thuneke

They are located in the C# Helper Functions Sample.

https://apiforums.easylink.com/content/c-sample-helper-functions

Tom

criesgo@simplexhealthcare.com

The JobSubmit FaxOptions example doesn't appear to show an example of how to send to a single recipient (or isn't very clear). All I see is how to send to a CSV List or how to send to a list that is already set up @ easylink.

Am I missing something?

thuneke

You can look at the single destination SMS sample here:

https://apiforums.easylink.com/content/api-simple-fax-usuage#comment-1298

You just replace SmsType with FaxType.

thuneke

This is the correct URL:

https://apiforums.easylink.com/content/c-sample-jobsubmit-sms-options-single-recipient