Job check examples
Examples
Go directly to our postman collection of examples:
- Norce Commerce Connect Job examples in postman
- Some .net code examples using our nuget package (see below)
Using client libraries
Norce Commerce has client libraries for c#. Read more about them here:
-
Norce Commerce code repositories
(Github)
- Commerce Connect contracts and as a nuget
Common calls to Connect API
Job/Get
Job/Get is used to ask Norce Commerce about a certain job to get its information.
After a import request have been sent, you can call Norce Commerce Connect to view status of your job.
The basic status to check is StatusId
, which translates as:
- 1 = Initialized
- 2 = Succeeded
- 3 = Failed
- 4 = Validation failed
Examples in Postman
Examples in Client Libraries
Here is a code example using .net client library
//Using Storm Client library: https://github.com/StormCommerce/Storm.Connect.Contracts
//Nuget: https://www.nuget.org/packages/Enferno.Services.StormConnect.Contracts/
private static void Main()
{
var serviceUrl = "https://demo.api-se.norce.tech/commerce/connect/4.0/";
var applicationId = 0;
var secretKey = Guid.NewGuid();
// List details for specific job
var job = ImportMethod(serviceUrl, applicationId, secretKey);
// ...
// Recheck specific job to see updated status
var specificJob = GetJob(serviceUrl, applicationId, secretKey, job.JobId);
// List all jobs
var allJObs = GetJobs(serviceUrl, applicationId, secretKey);
}
public static JobDto GetJob(
string serviceUrl, int applicationId, Guid secretKey, int jobId)
{
using (var httpClient = new HttpClient())
{
var credentials =
Encoding.ASCII.GetBytes($"{applicationId}:{secretKey.ToString("D")}");
// Base64Encoded Basic authentication is used
var credentialsToBase64 = Convert.ToBase64String(credentials);
httpClient.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Basic", credentialsToBase64);
var jobResponse = httpClient.GetStringAsync($"{serviceUrl}job/{jobId}").Result;
return JsonConvert.DeserializeObject<JobDto>(jobResponse);
}
}
public static List<JobDto> GetJobs(
string serviceUrl, int applicationId, Guid secretKey)
{
using (var httpClient = new HttpClient())
{
var credentials =
Encoding.ASCII.GetBytes($"{applicationId}:{secretKey.ToString("D")}");
// Base64Encoded Basic authentication is used
var credentialsToBase64 = Convert.ToBase64String(credentials);
httpClient.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Basic", credentialsToBase64);
var allJobsResponse = httpClient.GetStringAsync($"{serviceUrl}job").Result;
return JsonConvert.DeserializeObject<List<JobDto>>(allJobsResponse);
}
}
ListJobs
Job/List lists all the jobs run since last log cleanup.
Examples in Postman
RestartJob
Job/Restart re-runs a job from the stored data already in Norce. Used mainly in debug scenarios.
Examples in Postman
Ping
Job/Ping does a system check. Used for checking uptime status of the Norce Commerce Connect service.
Examples in Postman
Suggested further reading
- Commerce Connect code examples
- Calling Commerce Connect
- Product and pricing integrations
- Supplier integrations
- Shopping integrations