API Code Examples Unified to cURL and Authentication Guide Corrected
We have aligned the code examples and the authentication and environment guides in the API reference with how integration actually works.
Key Changes
1. Authentication Guide Corrected (Channel API partners, please check)
The Channel API authentication guide in the FAQ did not match the actual spec.
- Before (incorrect): send keys in two headers,
x-api-keyandx-channel-key - After (actual spec): send your issued per-channel key in a single
Authorizationheader
Authorization: {your_issued_key}
The Vendor API (vendor → ONDA calls) works the same way. There is no separate token issuance step (such as OAuth). The "OAuth 2.0" mention on the introduction page has also been removed.
2. Code Examples Unified to cURL
Every reference page for the Channel API, Vendor API 1.5, and Vendor API 3.0 now shows a single cURL example.
- Examples include the
Authorizationheader - Long URLs and request bodies wrap by default, so you can read them without horizontal scrolling
- The Send button, which sent requests to the server directly from the docs page, has been removed. Copy the cURL example and run it from your terminal or API client
3. Environment URLs Organized per API
Environment URLs in the introduction and the FAQ are now listed per API. Previously only the Channel API URLs were listed.
| API | Development | Production |
|---|---|---|
| Channel API | https://dapi.tport.dev | Provided by your ONDA contact after testing in the development environment |
| Vendor API (3.0 / 1.5) | https://vendor.dapi.tport.dev | Provided by your ONDA contact after the contract is signed |
4. Guide Cleanup
- The "ONDA Hub Introduction" page has been merged into the introduction page. The old URL redirects automatically
- The Glossary page has been added to the guide menu
- The API menus on the English site are now shown in English
- The site theme now follows your system setting (dark/light)
Contact
If you have any questions about API integration, please feel free to contact us:
- Technical Support: techsupport@onda.me