Make a test HTTP call
Now that you have selected the editor you want to use, we recommend completing these first steps before building your first app:
Get an API token
To get your API token from Geocodify:
Got to the Geocodify website and click Sign Up to create an account.
Enter your details and click Register (or log in Google or GitHub).
At the bottom of the Overview page in your dashboard, copy your API Key and store it in a safe place.
You will use the Geocodify API key later, when you create your app.
Review the API documentation
To plan the HTTP call, study the Geocodify API documentation, paying particular attention to the information regarding Authentication, the API Base URL, the API Endpoints, and the query parameters for the Search API.
Authentication
This section provides authentication details.
For this API you need to use an API key, which should be included in your request query string using the api_key parameter, along with the value that you obtained from the Geocodify website.
API Base URL
This section provides the base URL that you will use to access all the API endpoints.
The base URL is https://api.geocodify.com/v2
API Endpoints
This section lists all the available endpoints.
For this use case, you will use the /geocode endpoint to get the coordinates of a specific address.
Query parameters for the Search API
api_key: The API key used for authentication.
q: The address for which you want to retrieve the coordinates.
Do a Postman test
It is good practice to test the HTTP call using Postman before building it in Make. This ensures that everything is working properly and helps you plan the HTTP call setup in Make.
In Postman, create a new request and add the necessary elements to make the HTTP call:
Method: GET
URL (base + endpoint):
https://api.geocodify.com/v2/geocodeQuery parameters:
api_key: your API key
q: address to search, for example Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France
Click Send.
The API responds (HTTP 200 OK successful response status code) with a JSON file containing the address information and the API key.
If something is not working properly, use the error that the API returns to troubleshoot any issues.
Make an HTTP call
After a successful Postman test, build your call using one of the HTTP modules in Make.
According to the Geocodify API documentation, you need to provide an API key as a query parameter.
While you could choose to make a generic request, the best option is HTTP > Make an API Key Auth request. This module lets you hide the API key, so it doesn’t appear in the scenario log and others can't see it when editing your scenario.
In the Scenario Builder, add the HTTP > Make an API Key Auth request module.
Click Create a keychain.
Change the name of the connections if you wish, then fill in the following:
Key: your Geocodify API key
API Key placement: In the query string
API Key parameter name: api_key
Click Create.
Add the necessary information for the API call, including the address for which you want to retrieve the coordinates:
URL (base + endpoint):
https://api.geocodify.com/v2/geocodeMethod: GET
Query string: q=Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France
Parse response - Yes (this allows you to map the response items if needed)
Click Save.
Save your scenario and click Run once.
After a successful run, your module output can be found under Output> Data > Response > Features> 1> Geometry> Coordinates.
You are now ready to create your custom app.
Last updated