The TRA digital services marketplace is a platform that links buyers, such as governments and enterprises, with sellers offering tested and proven solutions.
By making the API extensible through the website, it enables the UAE’s largest companies to post project tenders directly from their procurement portal on the TRA digital services marketplace.
to connect with API, please follow the below steps:
In order to connect to the API, you must include the supplied secret key in your header.
The secret key will be emailed you by us once your registration information is approved
Below is a sample format of how you will receive the secret key in your email.
Key |
Sample value |
---|---|
secret_key |
f807f416c225bb96f6010b334d5455ae5ca6016771f2c2e33169df5t47f6yg6o |
CreateOpportunity Http method: Post |
||||||
---|---|---|---|---|---|---|
Field |
Type |
Description |
Min length |
Max length |
Format |
Mandatory |
organizationName |
String |
Your organization name |
1 |
100 |
|
Yes |
firstName |
String |
First name of the contact person |
1 |
100 |
|
Yes |
lastName |
String |
Last name of the contact person |
1 |
100 |
|
Yes |
contactNumber |
Number |
Contact number of the person |
10 |
20 |
|
Yes |
emailAddress |
String |
Email address of the contact person |
|
|
Email address |
Yes |
title |
String |
The title of your opportunity |
3 |
100 |
|
Yes |
categories |
String Array |
Category of the opportunity |
|
|
7 options as Guid:
Digital Marketing: {730C4213-D167-4D4D-83D1-7085032A8A27}
Information Security solutions: {66D86824-9508-4DC7-B6CF-A8512ECFE2CE}
Information Technology Solutions: {BE02A780-044D-498D-BEC7-6EF225594E5D}
Managed Services: {80185881-6DAE-4BF4-83A5-24BEFE186CB7}
Mobile App Development: {D77A3575-FA43-4211-9E3D-951FCD050062}
Web and Software Development: {FD872032-32B0-4105-AAC2-6F790CFB312D} |
Yes |
description |
String |
Description of the opportunity |
|
|
html or plain text |
Yes |
expiryDate |
Number |
The duration for which the opportunity will be displayed on the website. The 3 options are: 7 days 14 days 28 days |
|
|
Expiry date can be from the following values: 7,14 or 28 |
Yes |
hasProcurementLink |
Boolean |
External URL to your procurement portal, if one exists |
|
|
|
Yes |
procurementLink |
String |
Physical URL of your procurement portal |
|
|
http/https url i.e. |
Yes if hasProcurementLink value equal to true |
procurementEmailAddress |
String |
Procurement contact email address |
|
|
Email address |
Yes, if hasProcurementLink value equal to false |
stringFiles |
Array |
Files associated with the opportunity that you want to submit. Could be files such as tender information, deviations, exceptions, financial documentation etc. |
|
5 files |
The array contains two fields fileName: your file name with extension
allowed extensions: .pdf, .doc, .docx, .xls, .xlsx |
|
Error |
Description |
400 |
|
Sample http request:
POST /myapi/OpportunitiesApi/CreateOpportunity HTTP/1.1
Host: marketplace.gov.ae
secret_key: 5871bd537387d969e82889eab40d1b6f88b8b0120271e4dddd58280414af4a99
Content-Type: application/json
{
"organizationName":"Marketplace",
"firstName":"Michael",
"lastName": "Wilson",
"emailAddress": "m.w@marketplace.com",
"contactNumber": "0505555659",
"title": "Supply and Implementation of Website Files Upload Scanning Solution",
"category": "{FD872032-32B0-4105-AAC2-6F790CFB312D}",
"description": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
"expiryDate":7,
"hasProcurementLink": true,
"procurementLink": "https://marketplace.gov.ae/",
"agreeToTermsAndConditions": true
}
Sample http response:
Sample C# code:
static void Main(string[] args)
{
var files = GetFile();
var model = new CreateOpportunity
{
OrganizationName = "Marketplace",
FirstName = "Michael",
LastName = "Wilson",
AgreeToTermsAndConditions = true,
Category = "{FD872032-32B0-4105-AAC2-6F790CFB312D}",
ContactNumber = "0505555659",
Description = "What is Lorem Ipsum?Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
EmailAddress = "m.w@marketplace.com",
ExpiryDate = 7,
HasProcurementLink = true,
ProcurementLink = "https://marketplace.gov.ae/",
Title = "Supply and Implementation of Website Files Upload Scanning Solution",
StringFiles = new OpportunityFiles[]
{
files
}
};
var json = JsonConvert.SerializeObject(model);
StringContent theContent = new StringContent(json.ToString(), System.Text.Encoding.UTF8, "application/json");
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Add("secret_key", "0c37d6ef2d7b22245df03c87d3ff1590106e967653f88549712a0a31bb56608f");
var verify = client.PostAsync("http://marketplace.gov.ae/myapi/OpportunitiesApi/CreateOpportunity", theContent).Result;
var response = verify.Content.ReadAsStringAsync().Result;
}
}
public static OpportunityFiles GetFile()
{
string path = @"C:\sample.xlsx";
// Calling the ReadAllBytes() function
byte[] readText = File.ReadAllBytes(path);
var stringFile = Convert.ToBase64String(readText);
return new OpportunityFiles { FileName = "sample.xlsx", FileString = stringFile };
}