How to integrate OneSky APIs into your translation workflow process

If you’re a Localization Manager considering how to translate your apps or a developer trying to speed up the translation process, using OneSky will decrease the time and human effort it takes from creating the text in your apps to getting them translated.

In this article, we’ll show you how OneSky’s APIs can provide an automated translation workflow without manually using our online platform.

Step 1: Create a project with our API. Set details such as the name, type (e.g. iOS app, website) and description.

POST https://platform.api.onesky.io/1/project-groups/:project_group_id/projects

Response  

status 201 Created

{
    "meta": {
        "status": 201
    },
    "data": {
        "id": 10476,
        "project_type": {
            "code": "website",
            "name": "Website"
        },
        "name": "Website",
        "description": "Words from company website"
    }
}

Step 2: Upload files directly from your developing environment with our Upload API. Make a call to detect when files are successfully imported.

POST https://platform.api.onesky.io/1/projects/:project_id/files

Response  

status 201 Created

{
    "meta": {
        "status": 201
    },
    "data": {
        "name": "string.po",
        "format": "GNU_PO",
        "language": {
            "code": "en-US",
            "english_name": "English (United States)",
            "local_name": "English (United States)",
            "locale": "en",
            "region" : "US"
        },
        "import": {
            "id": 154,
            "created_at": "2013-10-07T15:27:10+0000",
            "created_at_timestamp": 1381159630
        }
    }
}

Step 3: Let’s say you need to modify some strings in your base language (e.g. instead of “Enter” you want “Submit”).

You can integrate Github into your build process to detect changes in your strings, package the build, then upload the new files onto the platform. No need to do it manually each time!

Step 4: Place an order for professional translation with our Order API, or your translators can begin translating using our online platform!

Step 5: You can easily use our Export API to download the translated files from the platform into your dev environment by programmatically setting up a schedule (e.g. every day at 1AM) to export translation files that have a completed status:

GET https://platform.api.onesky.io/1/projects/:project_id/translations/status

Response

status 200 OK

{
    "meta": {
        "status": 200
    },
    "data": {
        "file_name": "string.po",
        "locale": {
            "code": "ja-JP",
            "english_name": "Japanese",
            "local_name": "日本語",
            "locale": "ja",
            "region" : "JP"
        },
        "progress": "92%",
        "string_count": 1359,
        "word_count": 3956
    }
}

***We also have Xcode, Eclipse, and other plugins that can do all of the above with just 1 click!

As you can see, our APIs can help you get from development to release in no time! Here is more information, or you can contact support@oneskyapp.com.

Happy translating!