RunTest with Salesforce Tooling REST API (asynchronous and synchronous)

Salesforce supports running test with Tooling REST API ,which are runTestsAsynchronous and runTestsSynchronous.

In this post I’ll show you what is the difference between runTestsAsynchronous and runTestsSynchronous.


1.Salesforce Account
2.apigee for Salesforce (
3.A TestClass (Id=01p10000001Faws) such as:


Running tests asynchronously allows methods to process in parallel, cutting down your test run times.
(In fact,it is really slow, even will cost you more than 10 mins :()

First,we need to login apigee with Salesforce OAuth2.
apigee apigee-auth2 REST API Version after V28.0 supports Tooling API,so change the endpoint from [] to [].
Set Request URL and Parameter like the following capture then send request. apigee-runTestsAsynchronous


As we see,the request will return an object Id,actually,it is an AsyncApexJob Id.
And we will find that a Test has been run at “Apex Test Execution”. Apex Test Execution Then how do we get the details of this Test Result?
Use Tooling API we can also Query the details from related sObjects. Here is the sObjects ER. ER

1.ApexTestQueueItem [Document]



2.ApexTestResult [Document]


3.ApexCodeCoverage [Document]



As the word, runTestsSynchronous will execute Apex tests synchronously so we can get the Test Result directly.
Set Request URL and Parameter like the following capture. apigee-runTestsSynchronous


And test will not run at “Apex Test Execution” in this way. Apex Test Execution-runTestsSynchronous That is why running test with Sublime Text3 + MavensMate is always faster than running with Salesforce Developer Console,I suppose.