FAQs

Here are the answers to common questions about our APIs and processes.

Account

Login with your GitHub or CorpPass credentials. For details, refer to Create an Account guide.

For information on the differences and which account you should use, refer to Create an Account guide.

To create a CorpPass account, approach your entity's CorpPass Administrator. For details, refer to Create an Account guide.

While CorpPass and GitHub credentials can be used to create SSG-WSG Developer Portal accounts, do note that the accounts registered are independent of each other (i.e. no data can be transferred/linked from one account to the other), and that these credentials are not interchangeable.

An email address is required for notifications. For example, if Conformance Test is required for activation of subscribed API(s), instructions and test cases will be sent via email.

Create App

Subscriptions to APIs require either 'Open' or 'Certificate' authentication. For details, refer to App Development guide.

The newly generated ClientID and Secret will replace the previous versions.

Use the OpenSSL command line to generate a certificate. For details, refer to Credentials guide.

Your certificate upload may have been unsuccessful for the following reasons: 1. The file format is invalid. Please ensure that the certificate is properly formatted, with a .pem file extension. 2. An invalid certificate was uploaded. Your certificate is not PEM encoded. Upload a correctly encoded certificate. If the problem persists, use a different certificate or generate a new one. 3. The certificate has been uploaded before. The certificate has already been registered in our system. If you are trying to upload a different certificate, upload the correct file. 4. The certificate contains a virus. Use an antivirus scanner to ensure that the certificate is safe for upload.

The new certificate will replace the previous versions.

Each app requires unique certificate to be generated and submitted.

If your certificate has expired, upload a new certificate via the app's Summary page. For details, refer to Credentials guide.

Use the OpenSSL command line tool to generate an encryption key. For details, refer to Credentials guide.

If your app was created using 'Certificate' authentication, you can only subscribe to 'Certificate' API(s). For information on 'Certificate' APIs, refer to App Development guide. If you would like to use OAuth API(s), create a new app using 'Open' authentication instead.

After an app is created, the App name, Description, and authentication type cannot be changed. Create a new app instead.

Apps created on CorpPass accounts will automatically be shared with other CorpPass accounts from your entity.

API Subscription

The current API rate limit is 1000 request per minute for each application.

There is currently no limit on API quota.

There is no limit to the number of APIs that you can subscribe to.

The API approval process varies, depending on the approvals and verifications required for each individual API. For details, refer to App Development guide.

These API(s) are 'Certificate' API(s) and require credentials submission for access. For details, refer to App Development guide.

You should receive an email containing steps to complete as part of the Conformance Test Verification process. If you have already submitted your Conformance Test results, it may take up to X working days to review and verify them. Upon successful verification, on your app's Subscription page, the API's "Status" column will change from "Pending" to "Active". For more details, refer to Conformance Test guide.

A subscription can only be cancelled after it has been approved.

On your app's Subscription page, the API's "Status" column will change from "Pending" to "Active".

API Docs

Mock APIs are provided in the API Explorer for testing purposes. For details, refer to API Explorer guide.

Information on the various approvals, encryption and testing required for each API can be acquired from the API Explorer page. Reminders for any additional steps required can also be found in the "Actions" column of your Subscriptions page. For details, refer to App Development guide.

Sample codes can be found on our GitHub page. Alternatively, select "Docs" (from the top menu), and "Sample Code". You will be redirected to our GitHub page containing sample code repositories. The GitHub link can also be accessed from our Homepage (near the bottom of the page), under "Explore Sample Codes".

Community and Support

Stack Overflow is an online community platform built for and moderated by programmers, to post questions and seek answers about programming. If you have any technical queries, you can post them on Stack Overflow. Note that since your question(s) will be posted in an online open community, the answers you receive may not be provided by a SSG-WSG personnel.

Tags contain a well-chosen word or short phrase that defines the question type/topic. Use tags that best describe/categorise your issue. For example, if you are posting a question regarding problems faced when implementing an API, use the "api" tag. Begin your question title with an identifier "[SSG-WSG]". An example will be "[SSG-WSG] Issues logging in using GitHub account". For more information on tag usages and creation, refer to https://stackoverflow.com/help/tagging.

Refer to our featured articles under the Articles page (Select "Articles" from the top menu), containing information on upcoming APIs.