Skip to content

Chore/update readme#143

Open
marcos-sinch wants to merge 3 commits into
mainfrom
chore/update-readme
Open

Chore/update readme#143
marcos-sinch wants to merge 3 commits into
mainfrom
chore/update-readme

Conversation

@marcos-sinch
Copy link
Copy Markdown

  • Fixed the custom HTTP transport example: transport is now assigned via sinch_client.configuration.transport after initialization, not passed to the constructor

  • Reorganized client initialization section: replaced the "SMS API" / "All Other APIs" split with a clearer Project auth (primary method) and SMS token auth (alternative, SMS-only) structure

Comment thread README.md Outdated
#### SMS API
For the SMS API in **Australia (AU)**, **Brazil (BR)**, **Canada (CA)**, **the United States (US)**,
and **the European Union (EU)**, provide the following parameters:
#### Project auth
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For project-based authentication, we have 3 kinds of APIs:

  • conversation API with its own regionalization (US / EU / BR) for regulatory purposes
  • SMS API (US / EU / BR)
  • all the others APIs, not regionalized
    And on top of that, we have the service plan Id auth for SMS with additional regions

=> I'd like to see this clearly stated in the README

  1. SMS => 2 parts: one with project auth, explaining the OAuth2 exchange, another one with servicePlanId (legacy) with a bearer token that never expires. The region MUST be set and there are different ranges of regions depending on the auth method (because ZAP is available on US/ EU / BR)
  2. Conversation: The region MUST be set (US/ EU / BR) and when integrating with SMS, the regions MUST be the same
  3. The rest of the APIs, which are not regionalized and don't need extra parameters than projectId / accessKeyId and accessKeySecret

Comment thread README.md Outdated
project_id="some_project",
transport=MyHTTPImplementation
)
sinch_client.configuration.transport = MyHTTPImplementation(sinch_client)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch!
Can you add an example of implementation of MyHTTPImplementation with a custom proxy and authentication, and also another HTTP library: httpx?

@marcos-sinch marcos-sinch requested a review from asein-sinch May 25, 2026 15:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants