Get an Apple Messages template version's language
/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}const language = await bird.amb.templates.versions.languages.get(
"bird_order_update",
"amv_01ky4x8e4genzb7way45txfkm1",
"en",
);
console.log(language.language, language.text);language = client.amb.templates.versions.languages.get(
"bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en"
)
print(language.language, language.text)language, err := client.Amb.Templates.Versions.Languages.Get(context.Background(), "bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en")
if err != nil {
log.Fatal(err)
}
fmt.Println(language.Language, language.Text)$language = $bird->amb->templates->versions->languages->get(
'bird_order_update',
'amv_01ky4x8e4genzb7way45txfkm1',
'en',
);
echo $language->getLanguage(), ' ', $language->getRevision();bird amb templates versions languages get <template-ref> <version-id> <language>curl -X GET "https://us1.platform.bird.com/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}" \
-H "Authorization: Bearer $TOKEN"{
"language": "en",
"text": {
"body": "Your order {{ order_number }} is on its way."
},
"revision": 1,
"content_hash": "sha256:3d948846f5f773fb7bed8ab81b57f3d0ff2cbff24cb549718f4d389f1ab0300a",
"updated_at": "2026-09-10T09:00:00Z"
}
Returns one language's full text, revision, content hash, and update time. The response echoes the language in its canonical BCP-47 form.
Parameter
template_refstringThe template's ID (amt_…) or slug.
version_idstringThe version that holds the language.
languagestringThe language as a BCP-47 tag. Case and separator differences are accepted and canonicalized.
Antwort-Payload
languageThe language in canonical BCP-47 form.
textStored text and files. Includes its {{ variable }} placeholders.
Untergeordnete Attribute anzeigen
text.bodyText displayed in the message. Use one U+FFFC object replacement character per attachment to control placement.
text.subjectSubject displayed above the message body.
text.link_previewsHow the links in body of a message you send are previewed. Each https://, http:// or www. link is sent as its own rich link, built from the linked page's title and image. Punctuation that ends a link's sentence is dropped, so it does not arrive on its own after the card.
For the image, the page's og:image is tried first, then its largest apple-touch-icon or icon, then the largest image in the page. layout applies to every preview in the message: icon and square try the icon first, and large tries the images in the page before the icon.
Only a text sent on its own can set link_previews. A request that sets it beside rich_link or interactive is refused with 422. Leave it out there, and links in that text become previews in the default layout.
A message is accepted and then ends send_failed when:
- It has more than 20 links.
- A page does not load over HTTPS, or has no title or usable image. Every page is fetched over HTTPS, upgrading
http://andwww.links.
Every link is checked before the first part is sent, so the customer receives none of the message. A retry after some parts were delivered checks only the parts still to send, so a link that stops loading by then fails the message after those parts arrived.
text.subjectSubject displayed above the message body.
text.attachmentsOrdered attachments. A send supplies each one by source_url or attachment_id.
Untergeordnete Attribute anzeigen
text.attachments.source_urlHTTPS URL Bird downloads and uploads to Apple. Required on a send unless attachment_id is given. A non-HTTPS URL is refused with a 422 AMBEndpointNotHTTPS. In a template it may contain {{ }} placeholders; the rendered value must be HTTPS. Returned on reads of attachments you sent this way.
text.attachments.nameDisplay filename.
text.attachments.mime_typeMedia type of the attachment.
text.attachments.sizeAttachment size in bytes. Absent until Apple holds the attachment.
text.attachments.attachment_idThe attachment to send, or this attachment's ID on a read.
text.attachments.nameDisplay filename.
text.attachments.mime_typeMedia type of the attachment.
text.attachments.sizeAttachment size in bytes. Absent until Apple holds the attachment.
text.link_previewsHow the links in body of a message you send are previewed. Each https://, http:// or www. link is sent as its own rich link, built from the linked page's title and image. Punctuation that ends a link's sentence is dropped, so it does not arrive on its own after the card.
For the image, the page's og:image is tried first, then its largest apple-touch-icon or icon, then the largest image in the page. layout applies to every preview in the message: icon and square try the icon first, and large tries the images in the page before the icon.
Only a text sent on its own can set link_previews. A request that sets it beside rich_link or interactive is refused with 422. Leave it out there, and links in that text become previews in the default layout.
A message is accepted and then ends send_failed when:
- It has more than 20 links.
- A page does not load over HTTPS, or has no title or usable image. Every page is fetched over HTTPS, upgrading
http://andwww.links.
Every link is checked before the first part is sent, so the customer receives none of the message. A retry after some parts were delivered checks only the parts still to send, so a link that stops loading by then fails the message after those parts arrived.
rich_linkStored link preview. Includes its {{ variable }} placeholders.
interactiveStored interaction. Includes its {{ variable }} placeholders.
revisionThis language's revision counter, used for concurrent-edit checks on draft writes.
content_hashA fingerprint of Apple Messages template content, prefixed with its algorithm. Compare it within this API version to identify the exact source without transferring it.
updated_atWhen this language was last saved. Null for a built-in template.
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.