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