Developer Garden ist der Name für die Entwicker Community der Deutschen Telekom. Developer Garden erlaubt den Zugriff auf die zentralen Services der Deutschen Telekom, wie z.B. Sprache Verbindungen oder der Versand von SMS Nachrichten über die Open Apis. Der Zugriff auf die API Services erfolgt über SOAP oder REST. Die Familie der Zend_Service_DeveloperGarden Komponenten bietet ein klares und einfaches Interface zur DeveloperGarden API und bietet zusätzlich Funktionalitäten um die Behandlung und Geschwindigkeit zu verbessern. BaseUserService: Klasse um API Anteile sowie Details von Benutzerzugangsdaten zu managen. IPLocation: Lokalisiert die angegebene IP und gibt deren Geo Koordinaten zurück. Arbeitet nur mit IPs welche dem Netzwerk der Deutschen Telekom zugeordnet sind. LocalSearch: Erlaubt die Suche mit Optionen in der Nähe oder um eine gegebene Geo Koordinate oder Stadt herum. SendSMS: Sendet eine SMS oder Flash SMS zu einer gegebenen Nummer. SMSValidation: Prüft eine Nummer um Sie mit SendSMS zu verwenden und auch um einen Rückkanal zu unterstützen. VoiceCall: Initiiert alle Anrufe zwischen zwei Teilnehmern. ConferenceCall: Man kann einen kompletten Konferenzraum mit Teilnehmern für eine AdHoc Konferenz konfigurieren oder auch eigene Konferenzen planen. Die Backend SOAP API ist hier dokumentiert. Bevor man damit beginnen kann die DeveloperGarden API zu verwenden muss man sich erst für einen Zugang anmelden. Mit der DeveloperGarden API hat man die Möglichkeit zwischen 3 unterschiedlichen Umgebungen zu wählen mit denen gearbeitet werden kann. production: In der Produktionsumgebung muss man für Anrufe, SMS und andere Services zahlen. sandbox: Im Sandbox Modus kann man die selben Features, mit ein paar Einschränkungen, verwenden wir in der Produktion ohne für Sie zu zahlen. Normalerweise kann man die eigene Anwendung während der Entwicklung testen. mock: Die Mock Umgebung erlaubt es eigene Anwendungen zu bauen und Ergebnisse zu erhlaten ohne das irgendeine Aktion auf Seiten der API ausgelöst wird. Für jede Umgebung und jedes Service sind einige spezielle Features (Optionen) zum Testen vorhanden. Sehen Sie bitte hier nach Details. Man kann allen Klassen ein Array an Konfigurationswerten übergeben. Mögliche Werte sind: username: Der eigene Benutzername für die DeveloperGarden API. password: Das eigene Passwort für die DeveloperGarden API. environment: Die Umgebung welche man ausgewählt hat. 'meinBenutzername', 'password' => 'meinPasswort', 'environment' => Zend_Service_DeveloperGarden_SendSms::ENV_PRODUCTION, ); $service = new Zend_Service_DeveloperGarden_SendSms($config); ]]> Diese Klasse kann verwendet werden um Quotenwerte fpr die Services zu setzen und zu holen sowie um Accountdetails zu holen. Die Methode getAccountBalance() kann ein Array von Account Id's mit dem aktuellen Kontostatus (Credits) holen. getAccountBalance()); ]]> Man kann mit den angebotenen Methoden Quoteninformationen für ein spezifisches Servicemodul holen. getSmsQuotaInformation( Zend_Service_DeveloperGarden_BaseUserService::ENV_PRODUCTION ); echo 'Sms Quote:
'; echo 'Max Quote: ', $result->getMaxQuota(), '
'; echo 'Max Benutzer Quote: ', $result->getMaxUserQuota(), '
'; echo 'Quotenlevel: ', $result->getQuotaLevel(), '
'; ]]> Man erhält ein Result Objekt welches alle Informationen enthält die man benötigt. Optional kann der QuotaInformation Methode die Umgebungskonstante übergeben werden um die Quote für eine spezifische Umgebung zu holen. Hier ist eine Liste aller getQuotaInformation Methoden: getConfernceCallQuotaInformation() getIPLocationQuotaInformation() getLocalSearchQuotaInformation() getSmsQuotaInformation() getVoiceCallQuotaInformation() Um die aktuelle Quote zu ändern kann eine der changeQuotaPool Methoden verwendet werden. Der erste Parameter ist der neue Poolwert und der zweite ist die Umgebung. changeSmsQuotaPool( 1000, Zend_Service_DeveloperGarden_BaseUserService::ENV_PRODUCTION ); if (!$result->hasError()) { echo 'updated Quota Pool'; } ]]> Hier ist eine Liste aller changeQuotaPool Methoden: changeConferenceCallQuotaPool() changeIPLocationQuotaPool() changeLocalSearchQuotaPool() changeSmsQuotaPool() changeVoiceCallQuotaPool() Dieser Service erlaubt es Lokalisierungsinformationen für eine gegebene IP Adresse zu erhalten. Es gibt einige Einschränkungen: Die IP Adresse muss im T-Home Netzwerk sein Nur die nächste größere Stadt wird aufgelöst IPv6 wird aktuell nicht unterstützt setEnvironment( Zend_Service_DeveloperGarden_IpLocation::ENV_MOCK ); $ip = new Zend_Service_DeveloperGarden_IpLocation_IpAddress('127.0.0.1'); print_r($service->locateIp($ip)); ]]> Der Lokalsuch Service bietet die lokale Suchmaschine suchen.de über ein Webservice Interface an. Für weitere Details wird auf die Dokumentation verwiesen. setWhat('pizza') ->setWhere('jena'); print_r($service->localSearch($search)); ]]> Der SMS Versandservice wird verwendet um normale und Flash SMS zu beliebigen Nummern zu versenden. Die folgenden Einschränkungen sind auf die Verwendung des SMS Service anzuwenden: Eine SMS oder Flash SMS darf in der Produktionsumgebung nicht länger als 765 Zeichen sein und darf maximal an 10 Empfänger versendet werden. Eine SMS oder Flash SMS wird in der Sandboxumgebung gekürzt und mit einer Notiz in DeveloperGarden ausgestattet. Die maximale Länger der gesendeten Nachricht beträgt 160 Zeichen. In der Sandboxumgebug können maximal 10 SMS pro Tag versendet werden. Die folgenden Zeichen werden doppelt gezählt: | ^ € { } [ ] ~ \ LF (Zeilenumbruch) Wenn eine SMS oder Flash SMS länger als 160 Zeichen ist, wird immer für 153 weitere Zeichen eine Nachricht berechnet (Quote und Kredit). Die Zustellung kann für SMS oder Flsh SMS bei Festnetzanschlüssen nicht garantiert werden. Der Sender darf maximal aus 11 Zeichen bestehen. Erlaubte Zeichen sind Buchstaben und Zahlen. Die Spezifikation einer Telefonnummer als Sender ist nur erlaubt wenn die Telefonnummer geprüft wurde. (Siehe SMS Prüfung) createSms( '+49-172-123456; +49-177-789012', 'die Testnachricht', 'meinName' ); print_r($service->send($sms));]]> Der SMS Prüfservice erlaubt die Prüfung einer physikalischen Telefonnummer um diese als Sender einer SMS zu verwenden. Zuerst muss setValidationKeyword() aufgerufen werden um eine SMS mit einem Schlüsselwort zu empfangen. Nachdem man sein Schlüsselwort erhalten hat, muss man validate() verwenden um die Nummer mit dem Schlüsselwort gegen das Service zu prüfen. Mit der Methode getValidatedNumbers() erhält man eine Liste aller bereits geprüften Nummern und den Status einer jeden. sendValidationKeyword('+49-172-123456')); ]]> validate('DasSchlüsselWort', '+49-172-123456')); ]]> Um eine geprüft Nummer als ungeprüft zu markieren muss die Methode inValidate() aufgerufen werden. Der Sprachanruf Service wird für das Setzen einer Sprachverbindung zwischen zwei Telefonverbindungen verwendet. Für spezifische Details lesen Sie bitte die API Dokumentation. Normalerweise arbeitet der Service wie folgt: Den ersten Teilnehmer anrufen. Wenn die Verbindung erfolgreich war, den zweiten Teilnehmer anrufen. Wenn der zweite Teilnehmer erfolgreich verbunden ist, werden beide Teilnehmer miteinander verbunden. Der Anruf bleibt geöffnet bis einer der Teilnehmer auflegt oder der Ablaufmechanismus eingreift. newCall($aNumber, $bNumber, $expiration, $maxDuration); echo $newCall->getSessionId(); ]]> Wenn der Anruf initiiert wurde, kann das Ergebnisobjekt nach der Session ID gefragt werden und diese Session ID für einen zusätzlichen Aufruf der Methoden callStatus oder tearDownCall() verwendet werden. Der zweite Parameter der Methode callStatus() erweitert die Ablaufzeit für diesen Anruf. newCall($aNumber, $bNumber, $expiration, $maxDuration); $sessionId = $newCall->getSessionId(); $service->callStatus($sessionId, true); // Den Anruf verlängern sleep(10); // 10s schlummern und dann tearDown $service->tearDownCall($sessionId); ]]> Konferenzanruf erlaubt es eine Telefonkonferenz zu konfigurieren und zu starten. Die folgenden Features sind vorhanden: Konferenzen mit einem sofortigen Start Konferenzen mit einem definierten Startdatum Wiederkehrende Konferenzserien Teilnehmer einer Konferenz hinzufügen, löschen und lautlos stellen Templates für Konferenzen Hier ist eine Liste der aktuell implementierten API Methoden: createConference() erstellt eine neue Konferenz updateConference() aktualisiert eine existierende Konferenz commitConference() speichert die Konferenz, und wenn kein Datum konfiguriert wurde wird die Konferenz sofort gestartet removeConference() entfernt eine Konferenz getConferenceList() gibt eine Liste aller konfigurierten Konferenzen zurück getConferenceStatus() zeigt Informationen für eine existierende Konferenz an getParticipantStatus() zeigt Statusinformationen über einen Konferenzteilnehmer an newParticipant() erstellt einen neuen Teilnehmer addParticipant() fügt einen neuen Teilnehmer zu einer Konferenz hinzu updateParticipant() aktualisiert einen Teilnehmer, normalerweise um den Teilnehmer stumm zu schalten oder Ihn erneut anzurufen removeParticipant() entfernt einen Teilnehmer von einer Konferenz getRunningConference() fragt die laufende Instanz einer geplanten Konferenz ab createConferenceTemplate() erstellt ein neues Konferenztemplate getConferenceTemplate() fragt ein existierendes Konferenztemplate ab updateConferenceTemplate() aktualisiert die Details eines existierenden Konferenztemplates removeConferenceTemplate() entfernt ein Konferenztemplate getConferenceTemplateList() fragt alle Konferenztemplates eines Benutzers ab addConferenceTemplateParticipant() fügt einen Konferenzteilnehmer zu einem Konferenztemplate hinzu getConferenceTemplateParticipant() zeigt die Details des Teilnehmers eines Konferenztemplates an updateConferenceTemplateParticipant() aktualisiert die Details eines Teilnehmers in einem Konferenztemplate removeConferenceTemplateParticipant() entfernt einen Teilnehmer von einem Konferenztemplates createConference('MeinName', $conferenceDetails); $part1 = new Zend_Service_DeveloperGarden_ConferenceCall_ParticipantDetail( 'Jon', 'Doe', '+49-123-4321', 'your.name@example.com', true ); $client->newParticipant($conference->getConferenceId(), $part1); // add a second, third ... participant $client->commitConference($conference->getConferenceId()); ]]> Man kann verschiedene Cacheoptionen setzen um die Geschwindigkeit zu verbessern um WSDL und Authentifizierungs Tokens aufzulösen. Als erstes müssen die Cachewerte des internen SoapClients (PHP) eingestellt werden. Die [PHP KONSTANTE] kann eine der folgenden Werte enthalten: WSDL_CACHE_DISC: aktiviert das Cachen auf Disk WSDL_CACHE_MEMORY: aktiviert das Cachen im Speicher WSDL_CACHE_BOTH: aktiviert das Cachen auf Disk und Speicher WSDL_CACHE_NONE: deaktiviert beide Caches Wenn man das Ergebnis der Aufrufe zum SecuritTokenServer cachen will kann man eine Instanz von Zend_Cache einrichten und diese an setCache() übergeben.