You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Although our Sandbox is not a Channel Partner's production environment but a testing environment instead, it can route your API calls to our mobile operators to provide a real response if you test your prototype application from a device connected to one of their networks. That requires that you are the mobile line holder and have the SIM card installed in such device.
30
+
Although our Sandbox is not a Channel Partner's production environment but a testing environment instead, it can route your API calls to our mobile operators to provide a real response if you test your prototype application from a device connected to one of their networks. This requires that you are the mobile line holder and have the SIM card installed in such device.
31
31
32
32
Movistar (Spain) and O2 (Germany) are already available for testing from the Telefónica Open Gateway Sandbox, and other Telefónica operators in other countries will be added soon.
33
33
34
-
The production mode is disabled by default for Privacy reasons, but you can enable it by filling in your legal information and accepting the terms and conditions in the form that the Sandbox console will offer you for that purpose. You will have to provide some mobile phone numbers of your own which will be added to a whitelist that will allow you to test the APIs in production mode from your own devices and will block API usage accessing someone else's personal data.
34
+
The production mode is disabled by default for privacy reasons, but you can enable it by filling in your legal information and accepting the terms and conditions in the form that the Sandbox console will offer you for that purpose. You will have to provide some mobile phone numbers of your own which will be added to a whitelist that will allow you to test the APIs in production mode from your own devices and will block API usage accessing someone else's personal data.
35
35
36
36
37
37
-**Mock mode**
38
38
39
39
You can test your application without the need to have a SIM card from one of our mobile operators. The Sandbox will provide you with a mock response for every API call you make.
40
40
41
-
The mock mode will also make available for you some APIs that are not still commercially available on our mobile operators, so you can test them in advance.
41
+
The mock mode will also make available to you some APIs that are not yet commercially available on our mobile operators, so you can test them in advance.
42
42
43
43
Check the [Sandbox mock responses](/docs/sandbox/mocks) guide for more information on how to use the mock mode and the mock responses you can expect.
44
44
@@ -50,7 +50,7 @@ Open Gateway APIs access is granted to applications, not developers, so every ap
50
50
51
51
[More information on Privacy](/docs/privacy)
52
52
53
-
Therefore the way to get credentials to test the APIs is to register an application in the Sandbox console. You will use your application credentials to authenticate your requests to the APIs from any test you code no matter if it is actually a comprehensive application or just a tiny script to run from the a command line interface.
53
+
Therefore the way to get credentials to test the APIs is to register an application in the Sandbox console. You will use your application credentials to authenticate your requests to the APIs from any test you code, no matter if it is actually a comprehensive application or just a tiny script to run from a command line interface.
54
54
55
55
> 📘 How to access the Open Gateway Sandbox
56
56
> To use the Sandbox, you must [join the Developer Hub](https://opengateway.telefonica.com/en/developer-hub) and enter in your [private area](https://opengateway.telefonica.com/en/profile/technical-toolbox/sandbox)
@@ -69,22 +69,22 @@ According to the usage modes described [above](#usage-modes)
69
69
70
70
3. Briefly describe your application as part of the application onboarding process so that mobile operators can understand the purpose of your tests and validate it
71
71
72
-
Since it is a testing environment, your application won't be rejected as per this information, but our Sandbox uses standard procedures to register applications in the mobile operators' systems which takes this data as mandatory.
72
+
Since it is a testing environment, your application won't be rejected based on this information, but our Sandbox uses standard procedures to register applications in the mobile operators' systems which takes this data as mandatory.
73
73
74
74
These are the fields you need to fill in:
75
75
76
76
- **Name**: A name to identify your application by the operators as an Open Gateway APIs consumer.
77
-
- **Full name**: Your application's commercial name by which operators can find it in your website or application stores.
77
+
- **Full name**: Your application's commercial name by which operators can find it on your website or application stores.
78
78
- **Description**: A brief description of your application's use case related to the usage of the APIs.
79
-
- **Redirect URL**: (Optional) For frontend triggered authorization flows, you must indicate an URI hosted on your servers for the flow to call back to your code for it to complete authorization and perform the service API request (check [frontend triggered authorization flow](/docs/frontend) for detailed information).
79
+
- **Redirect URL**: (Optional) For frontend triggered authorization flows, you must indicate a URI hosted on your servers for the flow to call back to your code for it to complete authorization and perform the service API request (check [frontend triggered authorization flow](/docs/frontend) for detailed information).
4. Check the specifications and accept the terms and conditions per API and operator
84
84
85
85
Each mobile operator has its own terms and conditions for the usage of each API, and its own technical specifications you will want to consider when it comes to consuming them, so you will need to accept them for each API you want to test on each operator you have previously selected.
86
86
87
-
Since our Sandbox is just a free testing environment, specifications are not binding and conditions are meant for safeguarding privacy, even given that only whitelisted phone numbers can be used when testing in the Production mode with our mobile operators. In the case of the Mock mode, a global simulated operator will provide you with mock responses being the terms and conditions of the program you are member to that applies.
87
+
Since our Sandbox is just a free testing environment, specifications are not binding and conditions are meant for safeguarding privacy, even given that only whitelisted phone numbers can be used when testing in the production mode with our mobile operators. In the case of the mock mode, a global simulated operator will provide you with mock responses, and the terms and conditions of the program you are a member of will apply.
88
88
89
89
90
90
@@ -103,21 +103,21 @@ To get your application credentials and use them in your prototype, go to the ap
Note that if you selected the Production mode, you will have to wait for the approval of your application by the mobile operators you selected. When your application status is "Completed" you are good to test the APIs with your applications's credentials no matter what end-user phone number you are using. If you only selected the Mock mode, you can start testing right away.
106
+
Note that if you selected the production mode, you will have to wait for the approval of your application by the mobile operators you selected. When your application status is "Completed" you are ready to test the APIs with your application's credentials, no matter what end-user phone number you are using. If you only selected the mock mode, you can start testing right away.
107
107
108
108
## Using the APIs
109
109
110
110
So far you have used the Sandbox console to register your application as the client to the APIs, which means your application is the entity granted access with its credentials.
111
111
112
-
> You can use this credentials directly in the [API reference](/reference)
112
+
> You can use these credentials directly in the [API reference](/reference)
113
113
114
-
Now you will use such credentials to effectively consume de APIs from your code. You can use any programming language and any platform that supports HTTP requests, or you can use the Sandbox SDK for convenience. Our Open Gateway Sandbox provides you with a Python SDK and will publish SDKs in other common languages soon.
114
+
Now you will use such credentials to effectively consume the APIs from your code. You can use any programming language and any platform that supports HTTP requests, or you can use the Sandbox SDK for convenience. Our Open Gateway Sandbox provides you with a Python SDK and will publish SDKs in other common languages soon.
115
115
116
116
[Check the pros and cons of using HTTP integration or SDKs to consume the APIs](./sdkreference)
117
117
118
118
When it comes to our Sandbox's SDK, the following particular considerations apply:
119
119
- Once you shift to a Channel Partner in a commercial stage, your production code will need to use their SDKs instead of the Sandbox's one you used for testing and prototyping or, in the worst case, you will have to use the HTTP integration method instead if no SDK is available for your app's language.
120
-
- Our Sandbox does not provide a fronted SDK, so if the use case you are prototyping triggers the authorization flow from the end-user device, you will need to implement it by coding HTTP integration. Once you progress to a production stage, you need to check your Channel Partner toolkit offering.
120
+
- Our Sandbox does not provide a frontend SDK, so if the use case you are prototyping triggers the authorization flow from the end-user device, you will need to implement it by coding HTTP integration. Once you progress to a production stage, you need to check your Channel Partner toolkit offering.
121
121
122
122
If you want to integrate the APIs from your code using HTTP requests, you will need to follow the [API integration guide](/docs/apiintegration) to understand the authorization flows and the API reference to know the endpoints and parameters you need to use.
0 commit comments