FOSSASIA API Files of Communities in Asia

The FOSSASIA.net project is an initiative to bring the Asian Free and Open Source Software and OpenTech community together and foster cooperation. We make it easy to find communities and projects on a map with links to the websites, social media channels, and automatically updated info from community blogs. The use of the FOSSASIA-API enables us to collect the data of communities in a decentralized way. This is important to us, as it keeps communities in control. They do not depend on our infrastructure and could potentially setup their own service.

Step by Step from API Generator to the your community listing on FOSSASIA.net.

1. Go to http://api.fossasia.net/generator/index.html and fill in the information about your community in the form and press "OK - generate...". Mandatory fields are marked with an asterisk. The more information you enter, the better.

2. Your results are displayed on the top right hand side (scroll up after you finished 1). If information is missing or fields are incorrectly filled, you will see it marked under the text box. Fill in or correct the information and generate the API file again.

3. Press the download button and save the file.

4. Now upload the file to the repository at https://github.com/fossasia/fossasia-communities.

5. Add the link (URL) of your “raw file” to the FOSSASIA API directory here: github.com/fossasia/directory.api.fossasia.net/blob/master/directory.json.

6. You community will be included in the FOSSASIA network as soon as a team member has reviewed it (usually within 1-2 days).

7. Please tweet about your work to http://twitter.com/fossasia, e.g. a tweet that looks like that “@fossasia Uploaded API-file to add #Beijinglug community to #FOSSASIA network here https://github.com/fossasia/fossasia-communities” It is important that you include “@fossasia” in your tweet to make sure we get your message.

For Updating your info, please note: If you want to update your information, please download or edit your API file. You can do so after the entering the API directory, in the drop-down menu on the top right. Then repeat step 1 to 7. So, the new file needs to be saved or downloaded again. And, then do not forget to upload the new raw file to the Web server, blog or git service again.

FOSSASIA.net Blog Post http://blog.fossasia.org/join-fossasia-community-network