Register

What can I do with the Developer Garden APIs?

Telekom offers you direct access to Telekom services such as telephony, message sending or IP localization via APIs (Application Programming Interfaces). You as a developer can incorporate these services in web and desktop applications as well as mobile applications - ranging from notification services in CRM and ERP solutions to callback buttons in online shops and web SMS in smartphone applications.

I would like to use your APIs. What requirements do I have to meet and how do I start?

To be able to start programming with our APIs you need Internet access and knowledge of any programming language that supports REST or SOAP. If you want to develop web applications, you also need a web server.

In addition, to access the APIs you must have an account in the Developer Center where you can manage your personal account – ranging from activation of the APIs to topping up the account and requesting an invoice. Once you have registered in the Developer Center, you can book the APIs you want under menu item "My Account". Top up your credit in the “Konto” area.

Here you can find an overview of the key steps for developing programs with our APIs. Our documentation also provides you with precise technical instructions.

What type of support is available?

You can find bilingual documentation with detailed information on the individual APIs (scope of function, example code, etc.), our SDKs and the REST and SOAP interfaces in the Developer Garden. You can also exchange information with other programmers in the forum or read answers to frequently asked questions in the FAQs. Using our contact form you can also contact the Developer Garden support team directly.

How can I keep up-to-date with regard to new features, services, etc. of the Developer Garden?

We recommend that you visit our blog regularly and subscribe to our newsletter. You can also obtain first-hand news from our Facebook and Twitter profiles.

Where can I find out about current maintenance work?

The footer provides you with a link to the status page where we list information on current maintenance work.

What is the situation with data protection? How secure is my information when I am working with Telekom APIs?

The APIs described are governed by the same strict data protection rules as Telekom. Your data is solely used for billing purposes and to ensure operation. You can find more information here.

Is usage of the APIs free of charge?

Access to the APIs and the incorporation of the services into your software applications is free of charge.
Usage of individual services, e.g., establishing a phone call or sending SMS and MMS messages incurs a charge. You can find details on this in the price lists of the individual APIs.

In our two test environments (sandbox, mock) you can test your applications free of charge. However, there are limitations, e.g., the length of a phone call or the number of messages that can be sent.

What do I need to consider when using different browsers (Internet Explorer/Firefox/Safari/Chrome) at developergarden.com?

To ensure that the Developer Garden displays optimally, we recommend at least the following browser versions:

• Internet Explorer 8
• Mozilla Firefox 3.5
• Safari 4

Do you have special student offers?

You can find our university program in the Developer Garden campus: We are happy to support end-of-term papers and final papers as well as student projects through workshops, presentations and individual advice. We will support you in the design, implementation and testing of your applications and will even provide you with a free-of-charge usage quota for our APIs. In addition, you can work with us as an intern or student trainee directly in the Developer Garden.

What APIs are currently available?

The following APIs are currently available in the Developer Garden:

• Send SMS – Send SMS to the mobile or fixed line network.
• Send MMS – Send multimedia short messages (MMS) from your own applications.
• Voice Call – Establish voice connections between two participants.
• Conference Call – Establish voice connections between multiple participants.
• IP Location – Localize Internet users via their IP addresses.
• Scout24 Marketplace - Access the content from AutoScout24, ImmobilienScout24, FriendScout24, JobScout24 and Local24.
• AutoScout24 - Integrate the AutoScout24 search into your applications - free of charge.
• ImmobilienScout24 - Incorporate properties, price information and much more into your applications.
• ClickandBuy - Integrate the ClickandBuy online payment system into your applications.
• Voice Record (Lab API) – Record voice messages and integrate them into applications.
• Cloud User Management (Lab API)
  Integrate a cloud based user management into your applications

What is a Lab API?

A Lab API can be used to test and create new ideas. It serves as an experimentation interface for the development of applications. The use of a LAB API is free of charge and does not require additional activation.
Hosting is implemented via Telekom’s laboratory and test environments.

The Developer Garden does not offer guaranteed availability for these APIs. Changes to the scope of services of a Lab API and its full shutdown are possible at any time. In addition, special data protection-related provisions apply.

We currently offer the Voice Record API and the Cloud User Management API in our Lab area. Voice Record enables you to record voice messages and to integrate them into your applications. Cloud User Management lets you integrate a cloud based user management into your applications.

Do I require special programming skills? What technologies are supported?

You should have basic knowledge in any programming language which supports REST or SOAP to be able to develop programs with our APIs. For Java, PHP and the languages of the .NET platform there are also Software Development Kits (SDKs) available to you. Using the SDKs reduces your programming efforts significantly: The development kits provide you with classes and methods to build your desired application with just a few lines of code. They relieve you of routine work so that you can focus on what’s essential.

What do I need an SDK for? Can I also do without it?

Of course, you can also develop applications without SDKs. You can address our APIs via SOAP or REST directly with the programming language of your choice.

The SDK (Software Development Kit) helps you, however, to use our interfaces in the easiest way possible and to save programming effort. The SDK also encapsulates changes, for example, which may be performed at the SOAP/REST interface so that the conversion of your web application becomes very easy in this case.

We recommend that you use the SDKs for the following reasons:

1. The token authentication process is made significantly easier.
2. A description of the interface to be integrated is available in English and German in the source code.
3. It becomes much easier to address our APIs.

Is it possible to use your APIs in parallel, e.g., simultaneous start of operation of Conference Call and Send SMS?

It is possible to use multiple APIs in parallel.

I would like to test your APIs before I pay for their use. Is that possible?

Of course. The sandbox and mock environment are available to you for that. Sandbox means that you can use the service live with certain limitations (e.g., length of call, SMS length). Mock, on the other hand, means that the service is used virtually to test whether the application behaves correctly, e.g., calling a virtual test number.

Can I validate my call number for sending SMS (text messaging) without programming this function?

If you would like to validate your call number to use Send SMS API, there is already a tool that exists to do so. The Send SMS Sidebar Gadget is free of charge and enables the sending of text messages via the Developer Garden SMS API.

Which development environments are available to me?

To use the Developer Garden Services, three different development environments are available to you:

How much does it all cost?

Access to the APIs and downloading the SDKs is free of charge. Using the services in the mock and sandbox mode does not cost you anything either.

When used live, however, most services incur usage-dependent costs which can be found in the relevant price lists.

What discounts does the Developer Garden offer?

Would you like to pay monthly by invoice and save money at the same time?
No problem!

We offer a payment-by-invoice option and provide discounts of up to 10 percent (and more!) on the standard price.

If you want to know more, please e-mail your preferred contact details to us at info@remove-this.developergarden.com.

We will then get in touch with you.

Can I use your APIs also for programming an Android or iPhone app?

Our APIs support access via SOAP or REST, which means that our services can be used on all end devices that support these standards. Our GT&C and service specifications do not limit usage to specific devices either. Whether and to what extent the manufacturer of the device allows third-party APIs to be used is not up to us.

If you have any questions just contact us or do some advance research on the Internet using the name of your mobile communications device and “REST” as search terms.

What is the Developer Center?

Use the Developer Center to manage your personal Telekom API account—from activating APIs, to topping up your account, to requesting invoices, through to updating your user data.

What is the difference between Developer Garden und Developer Center? Why do I need to register twice?

The Developer Center is the administrative area for your developer account. This is where you manage your personal user account—from booking APIs, to topping up your account, through to requesting invoices.

Developer Garden is our communication platform. It provides you with all the information you need about Telekom’s developer programs. You will find detailed descriptions of our APIs as well as documentation and you can download our SDKs (Software Development Kits). Once you have logged in you can edit your personal profile, register for newsletters and research panels, and use the discussion board to share information with other developers or our support team.

Where do I find a current overview of my account balance?

Go to My Account > Account to check out your account balance.

How long will itemized bills be retained?

Your itemized bills are retained for 80 days.

Can I request an invoice for individual sub-accounts?

You can only create invoices for an account, but not for individual logins or sub-accounts. This is due to the fact that it is possible to transfer credit between individual accounts.

Can I request an invoice copy?

You can request any invoice up to three times.

Can I request a bulk invoice covering several transactions?

You can only request an invoice for a single transaction. You cannot group several transactions into one invoice.

Where do I find an overview of my transactions?

Go to My Account > Invoices. Here you can see all the transactions from the last three months and request an invoice for them.

What is the account overview?

The account overview in My Account gives you a summary of your Developer Center account. You can check your account balance and track your usage, top up your account, and create and manage one or several sub-accounts.

What is a sub-account?

In the overview in My Account you can create any number of sub-accounts for your account. You can assign these sub-accounts to different projects, giving you a better overview of your various projects and their costs. You can choose names for these sub-accounts, top them up individually, and enable or disable them as you like. You can transfer your credit (points) between the individual accounts anytime.
An overview of all your accounts with their current status and credit balance helps you to keep track of all your activities.

How do I specify the account to be used for billing the services I have subscribed to?

Each sub-account has a name you can choose yourself and an account ID for identifying it. Whenever you use a billable service you can specify the account ID—i.e., the sub-account—to be used for billing this service. If you don’t specify an account ID the main account will be used for billing.

Will I lose my credit when I disable a sub-account?

No, you will not lose any points. They will automatically be transferred to the main account where they will be available for further use.

What is the usage overview?

The usage overview summarizes the points used up so far by your main account as well as every single sub-account. The detail view shows you an itemized list of all the costs incurred. You can also export this overview into a .csv file (download).

How can I delete my account?

If you want to delete your Developer Garden account, simply send us an informal e-mail at info@remove-this.developergarden.com and we will take care of it.
 
To delete your Developer Center account, send us a message at info@remove-this.developercenter.com.
 
Please note that you have to request the deletion of Developer Garden and Developer Center accounts separately.
 
Please note that if your Developer Garden account is deleted, the contents that you have published under that account in the portal – in the forum, for example – are not deleted. The contribution author is anonymized, however, which means you can no longer be identified as the author of the content.
 
Please also note that the deletion of an account is final and cannot be reversed.

What methods are there for topping up my account(s)?

You can top up your account manually or choose an automatic top-up method. With manual top-ups, you top up your account immediately with the amount required. With automatic top-ups, you specify when your account should be topped up automatically. All top-ups use the prepaid procedure.

If you are interested in a postpaid procedure you can apply here. Depending on revenue, we are offering you an attractive discount (10 % or more!) on the standard price.

How do I top up my account?

Go to My Account > Account. Choose the relevant account, click Top Up Account and follow the payment process. You can also use the selection fields for redeeming vouchers. Alternatively you can set up an automatic top-up method per account.

What payment procedure can I use to top up my points?

Our prepaid top-up process enables you to pay by credit card (VISA, Mastercard, American Express), PayPal, ClickandBuy and cell phone (subscription or prepaid).

How can I pay by cell phone?

Simply enter your cell phone number in the online payment mode and you will receive a text message containing a transaction number (TAN). Enter this TAN into the online form to confirm payment. The TAN is valid for 10 minutes and can only be used once. Once the TAN has been used, the amount is billed to your cell phone bill or deducted from your prepaid credit.

Note: Paying by cell phone is only possible with a German cell phone number. All mobile providers in Germany are supported. This service is not available for fixed-network numbers.

Is it also possible to use the postpaid procedure?

In principle, all billing takes place using a prepaid procedure. We are, however, looking for particularly exciting business ideas and applications whose development we would be willing to support using an bill-based payment procedure. Depending on revenue, we are offering you an attractive discount (10 % or more!) on the standard price.

Just contact us in case you are interested in switching your account.

What automatic top-up methods are there?

You can choose between two automatic payment methods: limit-controlled or time-controlled top-ups.

With time-controlled top-ups, you specify the interval (e.g., daily, weekly, monthly or quarterly) and the amount for topping up your account. This method enables you to determine how much will be charged to your account. Please note, however, that your application is not fully functional with an empty account.

With limit-controlled top-ups, on the other hand, you specify the bottom limit your account shouldn’t fall short of, and the amount to be automatically credited to your account once this limit is reached. With the limit-control method you ensure that your subscribed services are always functional even when using your application a great deal.  Please note, however, that you do not have full control over your costs with a publicly available application.

How can I transfer credit (points)?

Go to the account overview in My Account and see Transferring Credit. Here you can enter the points you want transferred and then use a dropdown menu to select a) the account from which to transfer, and b) the account to which to transfer your points. Click Transfer to ensure that the points are transferred as requested.

Please note that the points to be transferred may not exceed the credit available in the sender account.