[SalesForce] URI of Apex REST Class

I have created the following class

@RestResource(urlMapping='/Expense/*')
global class ExpenseWS
{


@HttpPost
global static void createExpense(String ExpenseName,String Type,Integer Amount)
{

Expenses__c e = new Expenses__c();

e.Expense_Name__c = ExpenseName;
e.Type__c = Type;
e.Amount__c = Amount;

insert e;



}


}

And I am able to successfully insert a expense using workbench REST explorer as shown below.

I would like to get the URI (endpoint) for this particular REST class so that I can invoke this REST resource from another org.

As per the guides I need to use the following notation.

https://ap2.salesforce.com/services/apexrest/Expense

I am not sure whether this is right because there is no unique org identifier in the above URI.
There could be thousands of instances under ap2.salesforce.com

I hope I am making sense.

Q : How to get the endpoint/URI for the above REST resource ?

UPDATE
Thanks .
The scenario which I am testing consist of two SF orgs..one sending expense data and another inserting expense data.

As such I have added the second org which absorbs the data sent (i.e where the post rest resource exists) in the first org's "Security Controls"->"Remote Site Settings".

I observed the following .

Can someone explain why the /services/apexrest/expense part of the URL is not accepted as endpoint by Salesforce ?

Best Answer

You have to authenticate before you can call the rest resource. You authentication is what allows you to access the endpoint

A little while ago, Paul McGurn blogged how to create a public (SOAP-based) web service via a Force.com Site. As Paul explains, you add your web service class to the Enabled Apex Classes in the Site’s Public Access Settings. You’ll also need to add the appropriate object and field-level permissions for any data you will be exposing; remembering, of course, that this web service will be accessible without any authentication!

As I was setting up a WebHook the other day, I realized that the same principle applies to Apex REST Methods – add the class and any relevant objects/fields to your Site’s Public Access Settings, and you can access the REST methods via the Site URL. Let’s code up a simple example; here’s my Apex class:

https://developer.salesforce.com/blogs/developer-relations/2012/02/quick-tip-public-restful-web-services-on-force-com-sites.html

Related Solutions

[SalesForce] How does Salesforce handle wildcards in a REST urlmapping property

EDITED: It works sometimes without any problem (even with the oldest Api 22.0 that supports RestResource) and sometimes incorrectly.

That depends on the order of classes sorted by the time of the last modification.

If you edit the class REST1.cls or generally that with the shortest urlMapping length (add a comment into) it starts to work as you expect.

It is not exactly incorrect, because * matches any string with any number of /. It seems that the text "the patterns with wildcards... select the longest (by string length)" should be understand only "the longest string before the wildcard". The order of compared matching is not explicitely defined by docs if these parts are the same. They mean only: /word/* is a longer and better match than /*.

They want to provide a fast service. Therefore they probably need firstly to do a coarse match by an index, then to try classes ordered by this index until the first match is found. If you can find a good index expression than it can be probably fixed, but it is much complicated by rules about the final slash. I'm skeptical of anything, except for asking a possible very small improvement in documentation.

Tested code exemples:
REST1

@RestResource(urlmapping='/invoices/*/')
global class REST1 {
    @HttpGet
    global static String getClassName() {
        return 'REST1';
    }
}

REST2

@RestResource(urlmapping='/invoices/*/totals/')
global class REST2 {
    @HttpGet
    global static String getClassName() {
        return 'REST2';
    }
}

REST3

@RestResource(urlmapping='/invoices/*/related/')
global class REST3 {
    @HttpGet
    global static String getClassName() {
        return 'REST3';
    }
}

It is better and more universal to use urlMapping string without the final slash, but is is not important for this question. Example:

@RestResource(urlmapping='/invoices/*')

It can catch both /invoices/something/ and /invoices/something, while the mapping with the final slash requires only this one. Every example in Apex docs (e.g. the qouted above) is without any final slash.

**EDITED ** because the problem was not initially reproducible.

[SalesForce] Problem passing period character / email address in Salesforce REST URLmapping

I have had a response from Salesforce support and I've also done a bit more experimenting. The problem comes from the . character not the @ and the word from salesforce was "using REST API .json and ,xml extension so there is a rule in load balancer that uses regex depending upon how many characters added after dot."

So the following examples are illustrative:

/services/apexrest/showaccount/bob@test          GOOD
/services/apexrest/showaccount/bob@test.co.uk    ALSO GOOD (the pieces after the . only 2 chars long)
/services/apexrest/showaccount/bob@test.com      ERROR 404
/services/apexrest/showaccount/bob@test.com/     GOOD

Looks like with the way that the regex is implemented you should be very careful if the URL can include the period character and terminate the URL with a / if possible

Best Answer

Related Solutions

[SalesForce] How does Salesforce handle wildcards in a REST urlmapping property

[SalesForce] Problem passing period character / email address in Salesforce REST URLmapping

Related Topic