{"id":21201658,"url":"https://github.com/oleander/ballou-sms-gateway","last_synced_at":"2026-04-27T17:31:40.048Z","repository":{"id":62553953,"uuid":"2647524","full_name":"oleander/ballou-sms-gateway","owner":"oleander","description":"Ruby bindings for Ballou's (ballou.se) SMS Gateway","archived":false,"fork":false,"pushed_at":"2014-08-16T07:50:07.000Z","size":151,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-11T17:10:19.847Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oleander.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-10-25T23:27:50.000Z","updated_at":"2014-08-16T07:30:23.000Z","dependencies_parsed_at":"2022-11-03T05:00:29.785Z","dependency_job_id":null,"html_url":"https://github.com/oleander/ballou-sms-gateway","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/oleander/ballou-sms-gateway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fballou-sms-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fballou-sms-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fballou-sms-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fballou-sms-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oleander","download_url":"https://codeload.github.com/oleander/ballou-sms-gateway/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fballou-sms-gateway/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32348044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T17:12:42.749Z","status":"ssl_error","status_checked_at":"2026-04-27T17:12:41.658Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T20:10:23.102Z","updated_at":"2026-04-27T17:31:40.030Z","avatar_url":"https://github.com/oleander.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ballou SMS Gateway\n\nRuby bindings for [Ballou's SMS Gateway](http://www.ballou.se/tj%C3%A4nster/sms-verktyg).\n\nFollow me on [Twitter](http://twitter.com/linusoleander) or [Github](https://github.com/oleander/) for more info and updates.\n\n## How to use\n\n### Send a message\n\n``` ruby\nBallouSmsGateway.new.username(\"u\").password(\"p\").from(\"Github\").to(\"070XXXXXXX\").message(\"Hello world!\").send!\n```\n\n### Send a message to multiply receivers\n\n``` ruby\nBallouSmsGateway.new.username(\"u\").password(\"p\").from(\"Github\").to(\"070XXXXXXX\", \"070YYYYYYY\").message(\"Hello world!\").send!\n```\n\n### Send a very long message\n\nAdd the `long` method to the chain to send up to *918* characters.\n\n``` ruby\nBallouSmsGateway.new.username(\"u\").password(\"p\").from(\"Github\").to(\"070XXXXXXX\").message(\"A very long message ...\").long.send!\n```\n\n### Options\n\nThe list below is a set of methods that can be chained, like above. **Order doesn't matter.**\n\n- **id** (String) (CR) (Optional) A unique ID for the text message. Used for statics. Default is a [UUID string](http://en.wikipedia.org/wiki/Universally_unique_identifier).\n- **username** (String) (UN) Ballou username.\n- **password** (String) (PW) Ballou password.\n- **from** (String) (O) Who is the SMS from? Up to 10 character using text or up to 15 character using only numbers.\n- **to** (String or Array\u003c String \u003e) (D) SMS receiver(s). May begin with a plus sign, otherwise just integers.\n- **message** (String) (M) Message to be send. Max 160 character, if the `long` flag isn't set.\n- **long** (No argument) (LONGSMS) (Optional) Makes it possible to send a long message, up to *918* characters.\n- **request_id** (String) (RI) (Optional) Default is a [UUID string](http://en.wikipedia.org/wiki/Universally_unique_identifier).\n\nTake a look at the [official (swedish) site](http://www.ballou.se/exempel/) for more information.\n\n### The send! method\n\nWhen you're done buildning your query the final thing todo is to apply the `send!` method.\nIt'll fire the request or raise an error if something was wrong.\n\nThe `send!` method returns a request object with the following methods.\n\n- **id** (String) A unique ID generated Ballou.\n- **request_id** (String) Request ID defined by you using the `request_id` method, or an auto-generated UUID string.\n- **sms_id** (String) ID defined by you using the `id` method, or an auto-generated UUID string.\n- **to** (String) Receiver specified by you using the `to` method.\n- **sent?** (Boolean) Was the SMS sent?\n- **valid?** (Boolean) Alias for `sent?`.\n- **error** (Fixnum) Error code. `0` if everything went okay.\n- **status** (Fixnum) Status code. `-1` means that the SMS was added to Ballou's queue.\n- **message** (String) A message from Ballou. This is set when a request goes wrong.\n\nHere are some custom states that might be useful to know about.\n\nWhen a request goes wrong, like `404`, `500` and so on, the `status` method is set to `-2`.\nThis, in most cases, means that you should take a look at the `error` status code for more information.\nError `7` means that the request resulted in a non `2xx` response. This should not happend unless Ballou goes down or in someway changes the API.\nTake a look at the `message` method for more information.\n\nFor *even* more information and status codes, visit the [official site](http://www.ballou.se/exempel/).\n\n## How to install\n\n    [sudo] gem install ballou_sms_gateway\n\n## Requirements\n\n*Ballou SMS gateway* is tested in *OS X 10.7.2* using Ruby *1.9.2*.\n\n## License\n\n*Ballou SMS gateway* is released under the *MIT license*.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fballou-sms-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foleander%2Fballou-sms-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fballou-sms-gateway/lists"}